Help:Extension:Linter/ja

 拡張機能は修正が必要あるいは可能なパターンの wikitext があるページを検出し、パターンの問題点と解決法を示すガイドを提供します.

エラーは特別ページ:LintErrorsにタイプごとにまとめられています. このページではこれらの問題が原因で達成できない目的と比較して、リントの問題の重大度に応じて分類します. Special:Expandtemplatesを使うと、これらの問題のいくつかを見つけやすくなります. 詳細情報および議論は下記を参照してください.

今後も機能の改善を続け、ノイズの除去やバグ修正によりlinter の検出結果をより処理しやすくしていきます. ただし現在の検出結果を利用しても対処できます.

'''編集者がすべきことも参照してください. '''

修正の対象と理由
今後の計画として、解析担当チームではLinterの拡張機能を活用してウィキテキストの以下のパターンを特定していく予定です： これらすべての対処が急がれるのではなく、場合によっては（利用者のLinter耐性により）対処の必要がないものもあります. 上記のLinterの課題は、サブセットごとに個別にゴールを設定して対処していきます. 私たち解析担当チームはそれらのゴールをなるべく透明化（公開）し、どの課題を解決するとどのゴールが達成されるか、ガイダンスを提供していこうとしています.
 * エラー（例：偽の画像オプション – 通常、原因はタイプミスか、あるいはMediaWikiのメディアオプション解析の脆弱性）
 * 非推奨（例：self-closing tags）
 * 解析のパイプライン変更により壊れるもの（例：TidyをRemexHTMLに置換）
 * HTML5では無効になるもの（例：centerやfontなど古いタグ）
 * 一時的に壊れており、編集者の意図しない形に誤って解析される可能性のあるもの（例：閉じていないHTMLタグ、入れ子が正しくないHTMLタグ）

'''説明を簡略化してよくある質問のページで提供しています. '''

目標: Tidy を置き換える
As part of addressing technical debt in the parsing pipeline of MediaWiki, we have been working to replace Tidy with a HTML5-based tool. However, doing so will break the rendering of a small subset of pages unless certain wikitext patterns are fixed. Specifically, issues found in the,  ,  ,  ,  , and   categories. In order to ensure that we don't stretch out this Tidy replacement too long, we have accordingly marked all these issues as high priority.

Verifying fixes for these lint categories
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.

目標: PHP パーサと Parsoid のレンダリングの標準適合性（compliance）を改善する
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.

目標: 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.

目標: 編集者の意図を明確化する
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.

目標: クリーンなマークアップの実現
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.

特定のページの lint エラーの更新時期
現状ではリント（構文エラー）のカテゴリはすべて、ページの解析中にParsoidが識別したエラーから生成されます. ページ（またはページ上に複製されたテンプレート）が編集されると、ChangePropはそのページの再解析を要求し、Parsoidは新しい結果をLinter拡張に送ります.

つまり新しいカテゴリが導入されると（もしくは従来のカテゴリが訂正されると）、すべての解析結果の修正には時間がかかるかもしれないということです（特にほとんど修正されないページの場合）. もし編集をまったくしなければ、個別の処理はスピードアップします（訳注：理論上は）. 原則はそうであっても、T161556ではすべてのページを再解析する方法を検討中です.

X という名前空間 (例: 議論) のページは修正の対象かどうか
修正の優先順位が高いのはコンテンツの名前空間のページです. その他はウィキごとに異なります. サンドボックスとして使われるページが大量にあり、そこではエラーは放置されています.

ツール

 * w:en:User:PerfektesChaos/js/lintHint – その時点の LintErrors (Parsoid メッセージ) をリスト化する JavaScript のガジェット
 * WPCleaner - Linter のインタフェースとして機能する Java プログラムで、一部のエラー検出も可能

関連項目

 * Parsoid/API#Wikitext to lint – wikitext から lint を生成
 * Parsing/Replacing Tidy – Tidy の置き換え
 * Parsing/Replacing Tidy/FAQ – Tidy の置き換えに関してよくある質問