Help:Extension:Linter/es

La extensión  identifica patrones de wikitexto que deberían o podrían arreglarse en las páginas, junto con algunas guías sobre qué problemas hay con dichos patrones y cómo arreglarlos.

La página Especial:Errores de sintaxis (Special:LintErrors) agrupa los errores por tipo. Algunos de estos errores pueden ser más fáciles de hallar mediante Special:Expandtemplates. En esta página, clasificaremos los problemas de sintaxis de acuerdo con la gravedad del problema, teniendo en cuenta las metas que estos problemas impiden alcanzar. A continuación se muestra más información y se discutirán estos puntos.

Seguiremos mejorando la funcionalidad para eliminar la interferencia, arreglar errores y facilitar el rendimiento del analizador, aunque el rendimiento actual está listo para usar y actuar.

Véanse también estas instrucciones simplificadas para editores.

deletable-table-tag
Help:Extension:Linter/deletable-table-tag

pwrap-bug-workaround
Help:Extension:Linter/pwrap-bug-workaround

misnested-tag
Help:Extension:Linter/misnested-tag

Qué arreglar y por qué
En adelante, el equipo de análisis sintáctico piensa hacer uso de la extensión Linter para identificar patrones de wikitexto:
 * que son erróneos (por ejemplo, opciones de imagen inexistentes – creadas habitualmente por errores tipográficos o porque el análisis de opciones para archivos multimedia en MediaWiki es frágil);
 * que están obsoletos (por ejemplo, etiquetas autocerradas);
 * que pueden dejar de funcionar debido a cambios en el analizador sintáctico (por ejemplo, reemplazar Tidy por RemexHTML);
 * que ya no son válidos en HTML5 (por ejemplo, etiquetas obsoletas como center o font);
 * que tienen la potencialidad de no funcionar o de ser mal interpretados por el analizador con respecto a la intención del editor original (por ejemplo, etiquetas HTML no cerradas o etiquetas HTML mal anidadas).

No todos estos patrones deben corregirse con prontitud o incluso en absoluto (dependiendo de tu tolerancia hacia los errores sintácticos). Se avanzan distintos objetivos mediante la corrección de distintos subconjuntos de los problemas descritos anteriormente. Nosotros (el equipo de análisis sintáctico) trataremos de ser transparentes en lo que se refiere a estos objetivos, y trataremos de proporcionar asistencia sobre qué correcciones avanzan qué objetivos.

Se proporcionan instrucciones simplificadas en la página de preguntas frecuentes.

Objetivo: reemplazar Tidy
Como parte del tratamiento de la deuda técnica en lo referente al analizador sintáctico de MediaWiki, hemos estado trabajado para poder reemplazar Tidy por una herramienta basada en HTML5. Sin embargo, hacer esto estropeará la presentación de un pequeño subconjunto de las páginas a menos que se arreglen ciertos patrones de wikitexto. Específicamente, problemas hallados en las categorías,  ,   y. Para poder asegurar que no prorrogaremos esta sustitución de Tidy por mucho tiempo, hemos marcado apropiadamente estos problemas con prioridad alta.

Verificar las correcciones para estas categorías de errores sintácticos
You can verify the fixes for these lint categories via the ParserMigration extension. If you enable "ParserMigration" in your preferences, a link will be added to the toolbox of all articles ("Edit with migration tool"). If you edit the wikitext for a page with this link, the preview will show you current output (Tidy) and new output (RemexHTML, the Tidy replacement) side-by-side and check how your edit changes the rendering.

Objetivo: mejorar la conformidad entre la presentación del analizador PHP y Parsoid
Right now, the HTML generated by the PHP parser is used for read views and the HTML generated by Parsoid is used by editing tools and the Android app among others. The parsing team, as one of its long-term objectives, wants to enable the use of Parsoid's output for both read views as well as for editing. Since Parsoid and RemexHTML are both HTML5-based tools, the lint categories that affect RemexHTML's rendering also affect Parsoid's rendering. We haven't yet identified any newer lint issues that affect Parsoid's rendering at this time, but will update this list as we identify any such.

Objetivo: conformidad de la salida con HTML5
This is a somewhat complex goal and we haven't yet arrived at an understanding about how important it is to pursue this goal or how far we should go with this. Additionally, it is not yet clear what mechanisms we wish to leverage towards this goal. For example, based on a bunch of discussions in different venues, User:Legoktm/HTML+MediaWiki outlines a proposal for handling the html5-deprecated big tag. In any case, fixing issues in the,   categories advance this goal. Given lack of clarity around this goal, we have accordingly marked the obsolete-tag category as a low-priority goal.

Objetivo: aclarar la intención del editor
Getting markup right is hard. Errors inadvertently creep through. While the parser does its best in recovering from these errors, in many cases, what the parser does might not truly reflect the editor's original intent. Given that, we recommend that it is best to fix the issues identified here to clarify the editor's intention. Issues in the,  ,  ,   categories seem to affect this goal. Since this is a fairly important goal, we have marked most of them with medium priority. However, we have marked the missing-end-tag category with a low priority since in a vast majority of cases, the parser does seem to recover fairly accurately. Nevertheless, we recommend fixing whatever can be fixed without too much effort, if only to assist comprehension by other human editors and tools.

Objetivo: un marcado limpio
Getting markup right is hard. Even in the presence of errors, the parser does a fairly decent job in most cases in figuring out accurately how that piece of markup is supposed to render. But, in much the same way that typos, punctuation and minor grammatical errors can feel unsettling, some editors or those with a developer-mindset might find lint issues in these categories unsettling. We don't recommend spending an inordinate amount of time fixing these issues and, in many scenarios, bots might be able to fix these up as well. ,,   lint categories affect this goal.

Véase también

 * Parsoid/API#Wikitext to lint
 * Parsing/Replacing Tidy
 * Parsing/Replacing Tidy/FAQ