Consider using MyST
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 5/5
- Tiempo estimado
- Más de una semana
- Aptitud para principiantes
- 35/100
- Tipo de issue
- Nueva funcionalidad
- Claridad
- Bastante claro
- Estado de actividad
- Estancado
- Stack tecnológico
- markdown
- Área
- documentation
Línea de trabajo
En el issue no se mencionan archivos ni pruebas. Lee primero la introducción enlazada al analizador MyST y, después, localiza la configuración de Sphinx de docs.appimage.org; se considera terminado cuando MyST Markdown sea compatible y el reStructuredText existente siga siendo utilizable.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Currently we are using reStructuredText for docs.appimage.org but some users (including myself) strongly prefer Markdown.
reStructuredText offers more powerful features but also has an entirely unfamiliar (at least to me) syntax, resulting in me avoiding to touch the documentation altogether.
MyST could be the solution:
The MyST-parser is a Sphinx parser for the MyST markdown language. When you use it, Sphinx will know how to parse content files that contain MyST markdown (by default, Sphinx will assume any files ending in .md are written in MyST markdown).
It allows one to use directives in Markdown.
It is even possible to use both MyST and reStructuredText.
https://myst-parser.readthedocs.io/en/latest/using/intro.html#intro-writing
- Lenguaje dominante
- HTML
- Estrellas
- 50
- Forks
- 46
- Merge medio
- 7 h 19 min
- PR fusionados (30 d)
- 3
Preparar el entorno
- Incluye un Dockerfile o un archivo de Docker Compose
- Sin plantilla de pull request
- Sin guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de AppImage/docs.appimage.org
-
linuxdeploy is also available on ARMPosiblemente ocupada @Korne127 la tomó hace 804 días. Abierto
Dificultad 1/5 Menos de una hora Aptitud para principiantes 68/100
AppImage/docs.appimage.org#98 · 2 comentarios ·
-
Cannot register on DiscourseAbierto
Dificultad 4/5 3-5 días Aptitud para principiantes 35/100
AppImage/docs.appimage.org#148 ·
-
Dificultad 2/5 Medio día Aptitud para principiantes 45/100
AppImage/docs.appimage.org#127 ·
-
Dificultad 5/5 Más de una semana Aptitud para principiantes 25/100
AppImage/docs.appimage.org#121 ·
-
Convert to MarkdownAbierto
Dificultad 5/5 Más de una semana Aptitud para principiantes 35/100
AppImage/docs.appimage.org#105 · 4 comentarios ·
Todos los issues de AppImage/docs.appimage.org
Issues similares
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 82/100
sierra-research/tau2-bench#635 ·
Los mantenedores suelen responder en 1 día
-
The add-ssm-model skill requires a Cython simulator; the contributing guide allows Python onesPosiblemente ocupada @fmuia la tomó hoy. Abiertodocumentation skill
Dificultad 2/5 1-3 horas Aptitud para principiantes 83/100
lnccbrown/ssm-simulators#406 ·
Los mantenedores suelen responder en 4 días
-
Dificultad 1/5 Menos de una hora Aptitud para principiantes 95/100
btclib-org/btclib-ecc#309 ·
Los mantenedores suelen responder en 1 día
-
area: backends type: docs
Dificultad 1/5 1-3 horas Aptitud para principiantes 83/100
schlessera/brain-kit#2383 ·
Los mantenedores suelen responder en 1 día
-
documentation good first issue
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
yunusarda-sudo/arda-suite#15 ·
Los mantenedores suelen responder en 1 día