テンプレート:Marker/doc/sandbox
| この文書は草案です。まだ公式なものではありません。内容に関してノートページで議論を行っています。 |
- 経緯:翻訳の原文はドイツ語版 de:Vorlage:Marker/Doku &oldid=1723994 から転記します。2025-11-02T16:19:36時点におけるRolandUnger さんによる版。(+color)
- 目的=下の表のように、Markerテンプレートを置いたページでエラー警告を出す「type」があります。その解決策として、従来の解説文(Marker/doc)を更新をしたい。
- 必要な作業
エラーを出す原因は、パラメータ(引数)が古いから。新しい引数は#機能説明を参照。
- 00 Marker/doc の導入部
- ▲要更新、推奨されるパラメータ:の上書き。
|type「type=」をvCard式に変えます。← 従来は「listing」の要素でした。
- エラーを出す「type」の変数(値)
| 箇条書き:listing、都市:city |
| 着く:go、移動する:go, around |
| 観る:see、する do、買う:buy |
| 食べる:eat、飲む:drink |
| 泊まる:sleep、その他:other |
| 周辺:vicinity |
当面、エラー箇所の訂正に参考になりそう
処理済みのため除去。→ 【ご参考】
読み下しのため、ドイツ語版から目次を拾い、仮訳を当てます。ただし、この解説文の本文にはまだ反映してありません。
「DE」はドイツ語版の見出し。
↓ ここから翻訳版 ↓
記事冒頭のテンプレート類。
- {{de:template:DU}}
- {{de:template:High-risk}}
- {{Modul:Marker}}
- {{de:template:Benutzt Wikidata}}
- {{Vorlage:VCard/styles.css}}
- __NOTOC__(← 目次を表示しない設定)
概要
[編集]「Marker」テンプレートを使う代わりに、他のテンプレートのほうが適する場合があります。
- 「Marker」を使う場合は、その項目を動的地図に表示するためです。使う条件として、位置座標がわかる「地理オブジェクト」に限定されます。
- それ以外の場合には下記の「#代替テンプレート」が適します。
- 施設名は修飾子IDから推測できないので、書いてください。ソースコード内でテンプレート可読性を高めるためです。例外として、詳細データをウィキデータから読み込む場合(後述)は施設名の指定は不要です。
代替テンプレート:
- テンプレート:Sitelinks (ドイツ語版)
- {{vCard}}
機能説明
[編集]- 機能:このテンプレートは位置座標(緯度と経度)が利用可能に採用。(1)マーカ(色別のアイコン)と一覧(POI=Point Of Interest)に自動的に付番し、(2)動的地図上にマーカを表示します。対象するなら、段落全体(
block)には{{vCard}}テンプレートが最適、このテンプレートは文章の行(inline)の一部に書き込めます。 - 使用例:
{{marker|type=|name=|lat=|long=|wikidata=}>
必須パラメータ
[編集]|name=テキスト内に表示する施設名。名前は印刷可能な文字だけで記し、引用符"、制御文字、テンプレート、HTML タグは使用不可。また SGML 記法や XML 文字はできる限り使わないこと。印刷用の引用符は使用可能。システムから名称がエラーだと返してきた場合は、代わりにname-mapパラメータを用うと語形の変化形を指定可能ですが、それを指定すると地図上にマーカを表示できません。名称の書式は[[:de:name1|name2]]の場合に限って記事内にリンクでき、リンクには必ず名称の全文字を指定。リンク前後の文字は切り捨て。ただしname-extraの指定値を代用して、名称は拡張可能。名称に書式設定するなら、stylesパラメータを使いますが、アスタリスク記号「*」は使用不可。|type=は施設の種類(例:ホテル、レストラン、自然保護区)を示す。type 変数は {{vCard}} テンプレートと共通で、空白スペースは使えないし大文字と小文字は区別なし。type によりマーカの背景色が決まる。wikidataのみ変数を書いた場合は処理時間が遅れるので、必ず type も指定。どんな type があるか、表 を確認。
type によっては別名もあります。例:bus の別名 bus stop(バス停)。type には複数を書くことも可能で、その場合はコンマで区切ります。1番目の type でマーカの色が決まり、手動では指定できません。例を示します。
- 展望台
type = observatory - レストラン、バー、カフェ
type = restaurant, bar, cafe
- 展望台
typeのエイリアス(代替)は|types=。|lat=施設の緯度(Latitude)、有効範囲:-90.0~90.0、度分秒ではなく小数形式で指定。|latitude=位置座標latのエイリアス。|coord=位置座標latのエイリアス。
|long=施設の経度(Longitude)。有効範囲:-180.0~180.0、度分秒ではなく小数形式で指定。|lon=経度longのエイリアス。- {{Para|longitude} 経度
longのエイリアスです。
パラメータのオプション
[編集]|name-map=地図上に表示する施設名。名前は HTMLタグ、アスタリスク記号、引用符を含めないでください。ただし活字体の引用符は使用可能。この名称は文中に表示されないものの、名称nameの語形変化を参照するために利用可能。|name-extra=名称拡張子であって、名称の一部ではない文字列で、名称の末尾に表示。アスタリスク記号は使用不可。主な用途は、一時停止標識や公共交通機関のルート記号などを補うため。書式設定は名称と同じ。|name-local=機関名を地域言語で記述。有効にするスイッチ「= y」を指定name-local = yする記法だと、名称をウィキデータから読み込みます。|name-latin=施設名(現地語の表記に翻字)。|alt=代替名。アスタリスク記号は使用不可。機関名の現地表記を示したい場合は、name-localパラメータを使用。このパラメータを使ってはいけません。|url=名称に機関のURLをリンクさせる場合に使用。SNSのURLは指定不可。「 = n」スイッチをurl = nと指定すると、ウィキデータに URLを参照しに行かせません。|image=地図のマーカをクリックしたとき、どの画像のサムネイルをプレビュー表示するか、画像ファイル名を指定。接頭辞「file:」は書きません。|text=マップリンク内に表示させる平文(書式設定のない)の文字列。自動生成した数字や文字または座標の代わりに使います。画像も示す場合あり。|symbol=図形といいながら、複数の意味に対応する場合あり。大文字と小文字は区別なし。- number、letter、デフォルトはnumber。自動の番号付けを有効にします。
- 英数字(0~9、A~Z)1文字のみ、マーカとマップピンに図形ラベルを割り当て。これは通常、作成したマーカを重複して使用するため、特定の図形(シンボル)が既に自動の番号付けシステムで割り当ててあるかどうかは確認しません。
- 図形はMakiアイコンから選んで使用することも可能。適切な図形(シンボル)が見つからない場合は、「type」に基づいて自動で付番します。「symbol」の構造は小文字とハイフンのみ、数字は使用不可。図形タイプが不明で、有効なMakiアイコンもない場合にはエラーを示す濃いピンク色(フクシャ色)でプラス記号入りのマーカを表示。使用可能なMakiアイコンを確かめるには、モジュールファイルMakiアイコンを参照。図形の画像は
textパラメータにも入力可能。暫定的な解決策:「Text が空欄の場合、『シンボル名』の頭文字を大文字で示し、マーカに青い押しピンの図形を表示」。Maki アイコンがウィキメディア・コモンズで利用可能になると、押しピン柄のマーカと置換して表示されます。
|show=表示モードを設定。可能な値は、poi(POIのみ=既定)、all、coord(座標のみ)、none(座標なし)、symbol(数値の代わりに図形)、noname(名前なし)、nositelinks(URLなし)、socialmedia(SNSのリンク記号)、wikilink(内部リンク)。大文字と小文字は区別なし。|group=マーカ図形がどのグループに分類するか、自動的に判定して、以下のものを上書き。see(見る)、do(する)、go(行く)、buy(買う)、drink(飲む) eat(食べる)、sleep(泊まる)。既定は空欄。|map-group=地図のグループ名。これらグループ名は、文字と0~9の数字のみで構成。通常、このパラメータは複数の地図を使用する記事限定で使い、「map-group」パラメータをサポートする {{Marker}} テンプレートの唯一の目的は、特定の地図に置く {{Marker}} または {{vCard}} の所属を示すこと。マーカの色は「type」パラメータに連動。|zoom=ハイライト表示をクリックしたとき、地図のズーム値を示す。既定:17、有効範囲:1~19(1 = 地球、19 = 都市の一部:建物)。|wikidata=有効なウィキデータ修飾子が存在する場合、システムは名前、座標、画像および type の不足情報をウィキデータから取得しようとします。ウィキデータからデータを取得する場合は、このパラメータを必ず設定すること。|id=アンカーID。wikidataが未設定で、実際にアンカーが必要な場合に限定して記入。idに使える文字は半角の数字やアルファベット文字、ハイフン、アンダースコアのみ。スペースはアンダースコアに変換されます。Wikidata(ドイツ語版)のエントリは事前に確認してください。|commonscat=セットアップ用のメディアを含めて、ウィキメディア・コモンズのカテゴリを定義。このパラメータの記入は、ウィキデータに記載がない場合に限定して使用。|no-gpx=j/yは GPX ファイル内の出力を抑制。通常は重複をおさえるため 'symbol = [1-9A-Z]' と組み合わせる。|styles=名前のCSSスタイルに関する追加指示。短縮名normal、inherit(継承)、italic(斜体)、italic、station(枠線付き文字列)にも対応。
テスト期間に使えるオプションのパラメータ
[編集]|copy-marker=マーカ自体ではなく、代わりにマーカのコピーを挿入。指定できる値はWikidata Q-ID または施設名。|country=国名の指定はISO 3166-1 (例:de)にしたがう。施設の国情報が他にない場合は、このパラメータはほとんど不要。例えばテーマ別記事や歴史地域など、ウィキデータに場所の国情報が保存されていないときに使用。|copy-marker=マーカの代わりにマーカのコピーを挿入。値はウィキデータの Q-ID を使うか、施設名を指定。
|local-lang=言語コード。別の公用語を示す場合。|status=記事(stub, outline, ……guide, star, class-1, ……)または目的地(top-sight)の状態について、情報をカンマ区切りで一覧にする。この情報は記号に置き換えて、マーカアイコンの直前に置きます。大文字と小文字は区別なし。
「show」の引数
[編集]copy:パラメータ「wikidata」は、マーカをマーカコピーとして指定する。つまり、まず「wikidata」の設定が必要。noairport:空港IATAコードを出力しない。noname:マーカと座標のみ表示、名前は非表示(ウィキ間リンク、SNSも対象)。nositelinks:ウィキ間リンク、アイコンは非表示。socialmedia:▲SNSのアイコンも表示 > カテゴリ:SNSのリンクがあるvCard。symbol:マーカの白抜き文字は記号に置換。wikilink:ウィキデータからウィキボヤージュの記事に転送させない。記事が自己参照になってしまう場合に使える。カテゴリ:転送ページにリンクしたvCard。ドイツ語版のエラーカテゴリも参照。
使用する色
[編集]施設の種類別などで使用される色は、以下の通りです。
| 意味 | カラーコード | 意味 | カラーコード | 意味 | カラーコード | |||
|---|---|---|---|---|---|---|---|---|
| 地域 | #800000 | エラー | #FF00FF | 人口の多い | #00FFFF | |||
| 買う | #008080 | 行く | #A52A2A | 宗教 | #DAA520 | |||
| する | #808080 | 健康 | #DC143C | 観る | #4682B4 | |||
| 飲む | #2F4F4F | 自然 | #228B22 | 泊まる | #000080 | |||
| 食べる | #D2691E | その他 | #808000 | 景色 | #4169E1 |
|group=で使用できる色は、以下の通りです。
| 名前 | カラーコード | 名前 | カラーコード | 名前 | カラーコード | |||
|---|---|---|---|---|---|---|---|---|
| 桃色 | #FFCFCF | 金色 | #FFD700 | 黄緑 | #BFFF00 | |||
| 青緑 | #66CDAA | 橙色 | #FFA500 | 浅紫 | #DDA0DD | |||
| 紫 | #800080 | 赤 | #FF0000 | 銀色 | #C0C0C0 |
書き方の例
[編集]表の下の特徴も参照。
- 【凡例1】
- 地球儀アイコン=外部リンク(例2ほか)
- [W] アイコン=ウィキペディアに記事あり(例5ほか)
- [コモンズ]アイコン=ウィキメディア・コモンズに画像のグループあり(例5ほか)
- SNSアイコン=(show = socialmedia)これはサンプルとしてのみ露出[note 1](例10)
- 施設アイコン=ロンドンの地下鉄アイコン(name-extra =)
(例16)
- 【凡例1】
| No. | 構文(シンタックス) | 出力結果 |
|---|---|---|
| 例1 | {{marker | type = museum | name = 博物館 | lat = 51.17766 | long = 0.00115 }}[note 2] |
1 博物館 |
| 例2 | {{marker | type = museum | name = [[:de:Kairo/Ägyptisches Museum|Ägyptisches Museum]](カイロ・エジプト博物館) | lat = 30.047778 | long = 31.233333 | url = http://www.sca-egypt.org/eng/MUS_Egyptian_Museum.htm }}[note 3] |
2 Ägyptisches Museum |
| 例3 | {{marker | type = museum | name = 博物館 | lat = 51.27766 | long = 0.00115 | symbol = letter }}[note 4] |
A 博物館 |
| 例4 | {{marker | type = theme park | name = テーマバーク<!-- Themenpark --> | lat = 51.37766 | long = 0.00115 | image = Beispiel.png | zoom = 15 | url = http://www.beispiel.com/ }}[note 5] |
1 テーマバーク |
| 例5 | {{marker | wikidata = Q82425 }}[note 6][note 7] |
3 ブランデンブルク門 |
| 例6 | {{marker | wikidata = Q151356 | name-map = ベルリンテレビ塔}}[note 8] |
4 ベルリンテレビ塔 |
| 例7 | {{marker | wikidata = Q668382 | show = all }}[note 9] |
1 ライプツィヒ・ハレ空港 (IATA:LEJ) (51° 25′ 26″ N 12° 14′ 11″ E) |
| 例8 | {{marker | wikidata = Q668382 | url = n | show = all }}[note 10] |
ライプツィヒ・ハレ空港 (IATA:LEJ) (51° 25′ 26″ N 12° 14′ 11″ E) |
| 例9 | {{marker | wikidata = Q668382 | show = noairport }}[note 11] |
ライプツィヒ・ハレ空港 |
| 例10 | {{marker | wikidata = Q20949716 | show = socialmedia }}[note 1][note 12] |
1 InterContinental Cairo Semiramis |
| 例11 | {{marker | type = museum | group = lime | symbol = 8 | name = 見どころ | name-extra = 3* | lat = 15.47766 | long = 0.00115}}[note 13] |
8 見どころ 3* |
| 例12 | {{marker | type = airport | symbol = airport | name = カイロ空港 | lat = 30.12194 | long = 31.40556 }}[note 14] |
|
| 例13 | {{marker | type = airport | show = symbol | name = カイロ空港 | lat = 30.12194 | long = 31.40556 }}[note 14] |
|
| 例14 | {{marker | name = ケルン大聖堂 | wikidata = Q4176 | show = symbol }}[note 7] |
|
| 例15 | {{marker | type = airport | styles = italic | name = ルクソール空港 | lat = 25.670833 | long = 32.706389 }}[note 15] |
2 ルクソール空港 |
| 例16 | {{marker | type = subway | name = リバプールストリート駅(Liverpool Street) | name-extra = [[File:Underground no-text.svg|14px|baseline]] | wikidata = Q801124 | styles = station }}[note 16] |
3 リバプールストリート駅(Liverpool Street) |
| 例17 | {{marker | type = museum | symbol = unbekanntes-symbol | name = 美術館(Kunstmuseum) | lat = 51 | long = 0}}[note 17] |
|
| 例18 | {{marker | type = | name = 不明な施設、「type」の指定がない| lat = 52 | long = 0}}[note 17] |
1 不明な施設、「type」の指定がない |
- 特徴
- 1 2 別記、SNSアイコン(show = socialmedia)の使い方の注意があります(例10)。#パラメータのオプション →「[[#| url =]]」も参照。
- ↑ 例1 「名称+type+位置座標」のみ。
- ↑ 例2 リンク名が欧文表示(Ägyptisches Museum ← エジプト博物館)。アイコンによって原因が変わります。#【凡例】を参照。
- ↑ 例3 地図アイコンの白抜き文字。既定は半角数字、「symbol = letter」と指定すると、半角の大文字アルファベット。
- ↑ 例4 ▲ クリックすると、ドイツ語版ではアイコン「Beispiel.png」を表示して、サンプルだとわかるはずBeispiel.png。
- ↑ ウィキデータのQ_IDだけ記入。もっとも簡略。「wikidata = Q82425」のみ。例14と比べてください。
- 1 2 例14 最も簡略。「wikidata = Q4176」を記入、地図アイコンを見せるため「show = symbol」を指定。
- ↑ 例6 「wikidata = 」と「name-map =」を指定。
- ↑ 例7 「wikidata = 」と「show = all」を指定。
- ↑ 例8 URLは示すが「url = n」リンクさせない。
- ↑ 例9 「show = noairport」IATA記号を表示しない。
- ↑ 例10 「show = socialmedia」はこのページの解説のために使います。記事ページではSNSへのリンクは使わないでください。
- ↑ 例11 「name-extra = 」記事中に地図アイコンを示した時に、字を添えるため。ここで使った「3*」は、地図表示では付かない。
- 1 2 例12の指定は「symbol = airport」。例13は「show = symbol」を採用しており、表示を比べてください。
- ↑ 例15 斜体(イタリック体)。
- ↑ 例16 ロンドン地下鉄のアイコン。
- 1 2 例17、18 構文にエラーがある場合。マーカの色は濃いピンク。
「show」の依存関係
[編集]|show=の引数の依存関係は、以下の通りです。
位置座標
[編集]| 引数 | 出力結果 |
|---|---|
poi | 5 コプト博物館 |
all | 6 コプト博物館 (30° 0′ 21″ N 31° 13′ 49″ E) |
noname | 7 |
all, noname | 8 30° 0′ 21″ N 31° 13′ 49″ E |
coord | コプト博物館 (30° 0′ 21″ N 31° 13′ 49″ E) |
coord, noname | 30° 0′ 21″ N 31° 13′ 49″ E |
none | コプト博物館 |
ウィキデータの使用
[編集]| 引数 | 出力結果 |
|---|---|
| 4 インディラ・ガンディー国際空港 (IATA:DEL) [◎ 1] |
noairport | 5 インディラ・ガンディー国際空港 |
- 注記
- 注記
注釈
[編集]留意点
[編集]poi(見どころ)の下位互換性(直近のドイツ語版テンプレート更新による変更)
|show=とnonameは同じように機能します。|url=は無視されます。
- マイクロフォーマット
- h-cardとmicroformats2(英語)を使用します。
ウィキデータから情報を取得
[編集]このテンプレートは、ウィキデータから情報を読み込むことも可能です。
- 必須パラメータ
|wikidata=上書きされる場合を除き、ウィキデータから名前や座標、タイプや公式サイト、空港コードや画像、ウィキ間リンク(姉妹プロジェクトのウィキペディアやウィキメディア・コモンズ、ウィキデータなど)を取得します。
- パラメータの有効、無効を切り替える
|param=j, ja, y, yes利用可能な場合はウィキデータから取得。|param=n, no, neinたとえ存在していても、ウィキデータから情報を読み込みません。
- デフォルト値
|image=yes|url=yes
- 情報の取得がウィキデータ限定のもの
iata、icao常にウィキデータから自動的に取得。
取得した値の特殊な処理
[編集]IATAおよびICAOの空港コードは、ウィキデータから情報を取得し、空港コードは自動的に名前に追加します。
空港コードを非表示
[編集]空港は{{VCard}}に従って、空港名と姉妹プロジェクトへのリンクに、空港コードを自動で加えます。空港コードを非表示にするには、|show=noairportと指定。
利用できるアイコン
[編集]
挿し絵の画像は、Maki icons(マーカ・アイコン)の一覧です。バージョン7.2以降、地図に表示できるようになりました。詳細は別のページをご参照ください。
書式テンプレート
[編集]技術文書
[編集]- Wikivoyage:マーカー (ドイツ語版) - マーカーに関する技術文書です。特に、設定に必要な依存モジュールや、マーカーで使用されるCSSクラスが一覧にされています。
関連項目
[編集]関連テンプレート
[編集]- template:VCard - 施設の詳細な説明を表示。Markerに似ているが、もっと細かい情報が書ける。
- template:Mapframe - 記事に地図を挿入。
- template:複数マーカ (ドイツ語版) ← 記事内に複数のマーカを置く。
- template:ウィキ間リンク (ドイツ語版) ← リンク元のウィキ※をアイコン表示(※:姉妹プロジェクトへのリンク)
関連のヘルプ
[編集]- ヘルプ:マーカ (ドイツ語版) – マーカーの設定に関するヘルプ記事。
- ヘルプ:マーカ/Type (ドイツ語版) – オブジェクトエントリに使用できる現在のタイプのリスト。
- ヘルプ:VCardの作成 (ドイツ語版) – VCardの作成に関するヘルプ記事。
- ヘルプ:記号 (ドイツ語版) – 記事内の記号に関するヘルプ。
TemplateData
[編集]地図マーカの書式設定
| パラメーター | 説明 | 型 | 状態 | |
|---|---|---|---|---|
| 施設名 | name | 語形変化も可能。名称には印刷可能な文字のみ使用でき、制御文字、テンプレート、HTMLタグは使用不可。 | 文字列 | 必須 |
| 追加の名前 | name-extra | 付加情報だが名前の一部ではない。例えば象徴的な画像も含む。 | 文字列 | 省略可能 |
| 現地語の名称 | name-local | 組織の現地名。通称ではなく正式名。 | 文字列 | 省略可能 |
| アルファベット表記 | name-latin | 正式名称をラテン文字で記した表記(翻字)。 | 文字列 | 省略可能 |
| 地図上の別名表示 | name-map | 施設が地図上に表示される別名。格のない名詞形。 | 文字列 | 省略可能 |
| 別名、通称 | alt | 施設の別名(Alternativer Name)、ニックネーム。現地語の名称を記す場合は別の項目を使用。 | 文字列 | 省略可能 |
| データ番号 | wikidata | ウィキデータのオブジェクト番号。 | 文字列 | 省略可能 |
| アンカーID | id | ウィキデータが未設定で、しかも実際にアンカーが必要な場合に限定。IDに使える文字種は数字、文字、ハイフン、アンダースコア「_」のみ。空白(スペース)は自動でアンダースコアに変換。 | 文字列 | 省略可能 |
| コモンズのカテゴリ | commonscat | ウィキデータに語彙素(Q番号)がない場合に限定。施設のメディアを含む。 | 文字列 | 省略可能 |
| タイプ | type types | 定義済みのタイプ名を入力。色はタイプに使用不可。 | 文字列 | 必須 |
| URL | url | 施設のURLアドレス。▲ SNSのURLは使用不可。 | 文字列 | 省略可能 |
| 緯度 | lat latitude coord | 施設の所在地の緯度。 | 文字列 | 必須 |
| 経度 | long lon longitude | 施設の所在地の経度。 | 文字列 | 必須 |
| マーカ画像 | image | マーカの画像 | 文字列 | 省略可能 |
| ズーム値 | zoom | 規定値は17。地図表示のズーム値、0~19の範囲。 | 数値 | 省略可能 |
| Symbol | symbol | 既定は数字。アイコンの種類を表す数字、文字またはマーカ・アイコンの名称。 | 文字列 | 省略可能 |
| 平文 | text | ウィキ文(平文)の表示。数字や文字など座標マップリンク内に自動生成される記述を代替。画像も含めてよい。 | 文字列 | 省略可能 |
| 表示モード | show | 通常(POIと名前のみ)のままか、変更する場合に限定。POI、座標および名称の表示・非表示を決定。指定可能な値は、all(既定)、poi、coord、none、noname、nositelinks、nowikilink、symbol。この「show」を使用する場合、マーカの書式設定は無効になる。 | 文字列 | 省略可能 |
| マーカのグループ | group | 自動的に決定されたグループ分類を上書き。対象は buy、do、drink、eat、go、see、sleep など。 | 文字列 | 省略可能 |
| 地図グループ | map-group | 使用場面が限定される情報。マーカを複数の地図に分散させる場合は必須。 | 文字列 | 省略可能 |
| GPX出力 | no-gpx | マーカー情報を GPX ファイルに出力させない場合は、値 j/y を yes に設定。 | 文字列 | 省略可能 |
| CSS書式 | styles | 名前のCSS書式に関する追加の指示。ショートカットのオプションあり=normal、inherited、italic、station(枠線付きテキスト)。
| 文字列 | 省略可能 |