Template:CS-ja documentation/urlのソースを表示

*<b id="csdoc_url">url</b>: {{#if:{{{media|}}}|出典|情報源の本文}}が閲覧できるURLを指定します。'''title'''に内部リンクをつけている場合、url引数は使用できません。ページごとにURLが異なる場合は特定ページへのURLを指定できます。<code>#ixzz2rBr3aO94</code>や{{nowrap|<code><nowiki>?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...</nowiki></code>}}といったトラッキング用の引数をURLから除去するようにしてください。Amazon.comなどの書籍販売サイトへのリンクは指定せず、代わりに{{para|isbn}}や{{para|oclc}}を指定して、より中立的な販売元検索リンクを提供するようにしてください。スペースが含まれているなど書式の正しくないURLはエラーを引き起こします。
**<b id="csdoc_accessdate">access-date</b>: '''url'''が指している内容が記事の出典であることを最後に確認した日付を指定します。内部リンクはつけないでください。この引数を指定する場合、'''url'''引数も必ず指定してください。ほかの出典のaccess-dateとarchive-dateと同じ書式で指定してください{{r|date|group=日付}}。{{tl|Cite web ja}}の場合のみ、必ず指定しなければなりません。刊行された学術論文や出版された書籍の場合は閲覧日を指定する必要はありません。<!-- See [[#csdoc_auto-date-format|"Automatic date formatting"]] above for details about interaction with {{tlx|use dmy dates}} and {{tlx|use mdy dates}}. -->[[Help:出典表記形式1/accessdate|カスタムCSS]]で非表示にしたり、表示を変更したりできます。別名: '''accessdate'''。
**<b id="csdoc_archiveurl">archive-url</b>: ウェブページの[[ウェブアーカイブ|アーカイブ版]]のURLを指定します。例えば、[[インターネットアーカイブ]]（[[Help:ウェイバックマシンの利用]]を参照）、[[archive.today]]（{{仮リンク|Help:archive.today|en|Help:Using archive.today}}を参照）、[[ウェブ魚拓]]のURLを指定できます。この引数を指定する場合、'''archive-date'''と'''url'''が必須になります。既定ではtitleにarchive-urlへのリンクがつけられ、元のURLへのリンクは末尾に表示されますが、{{para|url-status|live}}と指定することで逆になります。別名: '''archiveurl'''。
***<b id="csdoc_archivedate">archive-date</b>: アーカイブがなされた日付を指定します。「2011年2月23日時点のオリジナルよりアーカイブ」のように表示されます。出版日の書式と同じである必要はありませんが、ほかのaccess-dateやarchive-dateと同じ書式で指定してください{{r|date|group=日付}}。テンプレートで日付を指定することは非推奨となっており、内部リンクはつけないでください。<!-- See [[#csdoc_auto-date-format|"Automatic date formatting"]] above for details about interaction with {{tlx|use dmy dates}} and {{tlx|use mdy dates}}. -->別名: '''archivedate'''。
*** <b id="csdoc_urlstatus">url-status</b>: {{para|url}}もしくは{{para|archive-url}}のいずれかを利用して{{para|title}}に外部リンクを張るための制御引数です。この引数を使うには'''url'''と'''archive-url'''の両方が必須です。{{para|archive-url}}を使わずに{{para|url}}がリンク切れであることを明示するには、{{tlx|リンク切れ}}を出典テンプレートの後ろに追加してください。
***:値には以下のキーワードを受け付けます：
***:*<code>dead</code> – {{para|url}}がリンク切れである場合に指定します（{{para|url-status}}を省略するか、空文字列を指定した場合も同じ）。{{para|title}}に付けられる外部リンクには{{para|archive-url}}が使われ、{{para|url}}を用いた外部リンクは後ろの方に表示されます。
***:*<code>live</code> – {{para|url}}のリンクが現時点でまだ有効である場合に指定します。{{para|title}}に付けられる外部リンクには{{para|url}}が使われ、{{para|archive-url}}を用いた外部リンクは後ろの方に表示されます。
***:*<code>deviated</code> – {{para|url}}のリンク自体は機能するが、リンク先の内容が書き換えられたために出典として有効でなくなった場合に指定します。{{para|title}}に付けられる外部リンクには{{para|archive-url}}が使われ、{{para|url}}を用いた外部リンクは後ろの方に表示されます。
***:*<code>unfit</code> – {{para|url}}のリンク先において広告だけが表示されるなど、リンクを残しておくことが不適切な場合に指定します。{{para|title}}に付けられる外部リンクには{{para|archive-url}}が使われ、{{para|url}}を用いた外部リンクは生成しなくなります。
***:*<code>usurped</code> – {{para|url}}のドメイン自体が第三者によって再利用されており、リンクを残しておくことが不適切であったり危険性を伴う場合に指定します。{{para|title}}に付けられる外部リンクには{{para|archive-url}}が使われ、{{para|url}}を用いた外部リンクは生成しなくなります。
***:*<code>bot: unknown</code> – ボットが{{para|url}}のリンクが機能しているか判定を行ったものの、リンク切れかどうかの判別ができなかった場合に、この値が使われることがあります。この値が使われているページは [[:Category:CS1メンテナンス: bot: original URL status unknown]] に収集されます。カテゴリ内のページについては人の手によってリンクの確認を行い、値を上記の中から適切なものに置き換えるようにしてください。<!-- [[Help:出典表記形式1#ウェブアーカイブ]]にもurl-statusの解説がある -->
***<b id="csdoc_format">archive-format</b>: '''archive-url'''が指す作品のファイル形式（DOCX、XLSXなど）を指定します。媒体の種類はこの引数ではなく'''type'''引数を指定してください。'''title'''の末尾に(DOCX)のように表示されますが、[[Help:外部リンクアイコン|外部リンクアイコン]]はPDFを除いて変更しません。HTMLの場合は自明であるため指定しないでください。URLの拡張子がPDFになっている場合も自動的に判別するため、引数で指定する必要はありません。また、外部リンクアイコンには[[Wikipedia:画像の代替テキスト|代替テキスト]]が指定されないため、視覚障害者の方にはファイル形式の情報を提供できず、'''format'''で明示的に指定する必要があります（URLから自動的に判別できるPDFを除く）。
** <b id="csdoc_url_access">url-access</b>: [[#URLに関連する引数のアクセスレベル]]を参照してください。
*<b id="csdoc_format">format</b>: '''url'''が指す作品のファイル形式（DOCX、XLSXなど）を指定します。媒体の種類はこの引数ではなく'''type'''引数を指定してください。'''title'''の末尾に(DOCX)のように表示されますが、[[Help:外部リンクアイコン|外部リンクアイコン]]はPDFを除いて変更しません。HTMLの場合は自明であるため指定しないでください。URLの拡張子がPDFになっている場合も自動的に判別するため、引数で指定する必要はありません。また、外部リンクアイコンには[[Wikipedia:画像の代替テキスト|代替テキスト]]が指定されないため、視覚障害者の方にはファイル形式の情報を提供できず、'''format'''で明示的に指定する必要があります（URLから自動的に判別できるPDFを除く）。
{{MediaWiki URL rules}}
{{reflist|group=日付|refs=<ref name="date">脚注のaccess-dateとarchive-dateは出版日の書式かYYYY-MM-DDの書式に統一してください。</ref>}}<noinclude>
[[Category:内部テンプレート]]
</noinclude>