틀:Routemap/설명문서

노선도를 그릴 때 기존에 사용하던 노선도, BS 등의 틀을 Lua를 이용하여 통합한 틀입니다.
__TOC__

**사용법**

**기본**
 독립적으로 사용하고자 하는 경우 , , 을 이용해 도표 제목을 꾸밀 수 있다.- 철도 노선을 설명하는 표 안에 넣어서 쓰는 경우  인자를 사용한다.
** 표 안에 를 먼저 쓰고 그 밑에 을 친다.- 픽토그램(아이콘)의 코드(Wikipedia:Route diagram template/Catalog of pictograms)를 정해진 틀 안에 넣는 형태이다.- BS-map에서 각 칸을 구분할 때 사용하는 '|' 대신 '\'를 사용한다. '\' 사이에 픽토그램의 코드()를 쓴다.- BS-map에서는 양쪽에 를 넣지만 Routemap에서는 사용하지 않으며, (가로)칸수를 결정하는 BSn 같은 숫자도 쓰지 않는다.
** 예시) BS-map의  을 Routemap에서는 그냥  와 같이 쓴다.- 가로로 사용 가능한 칸수는 편집자 임의로 지정할 수 있다. | 대신 사용하는 '\' 사이에 픽토그램 코드를 쓴다. '\' 의 개수가 사용할 칸의 개수를 결정한다.
** 예시) \를 하나 쓰면 \ 왼쪽에 한 칸, \ 오른쪽에 한 칸 가로로 총 두 칸을 사용하겠다는 의미이며, BS-map의 BS2와 같다.    BS-map의  을 Routemap에서는  (가로로 2칸 사용) 와 같이 쓴다.- 오른쪽 끝에 내용을 넣을 때는 반드시 물결 표시()를 넣어야 한다.(BS-map에서 끝에 넣는 
' 한 개와 같은 역할을 한다.- 끝에 반드시 표를 닫는  를 써야 한다.- 거리는 다음과 같이 쓴다. → 

**고급**
 합성 기술은 을 다음과 같이 사용한다.
** 예시) 위에 를 합성하고 싶다면 과 같이 쓴다.- 합성 기술은 한 번 밖에 못 쓰는 BS-map과 달리 무한정 사용할 수 있다.- BS-map과 달리 노선도 왼쪽에도 내용을 넣을 수 있다. 
** 예시)    에서 왼쪽에 내용을 넣고 싶다면   같은 식으로 쓴다.

**기타 사항**
 틀:BS-map과 마찬가지로 여기서도 용량이 지나치게 클 경우 오버플로를 일으켜 틀이 누락된다. - 칸수는 무한정 늘릴 수 있다.- 링크()는 제대로 걸어야 한다. 대괄호를 하나 빼먹기라도 하면 사진과 같이 노선도가 망가진다. 
설명) 가운데 '거리'에 링크를 걸었는데 대괄호가 하나 빠져 있다.

**문제 발생 시**
 1. 마지막에 괄호 두 개()를 제대로 넣었는지 확인한다.- 2. 링크()를 잘못 걸지는 않았는지―대괄호를 하나 빼먹었다든지―확인한다.- 3. 유효하지 않은 픽토그램 코드를 사용하였는지 확인한다. 

**기타**
 BS-map은 스마트폰 등 모바일에서 틀이 깨져나와 제대로 볼 수 없지만 Routemap은 모바일에서도 잘 나온다. 자신이 작성한 노선도가 그렇게 나오기를 원하지 않는다면 Routemap으로 작성하길 바란다.

**인수**
{
	"description": "통일된 형태의 아이콘 그림을 이용하여 노선도를 그려주는 틀입니다.",
	"params": {
		"inline": {
			"label": "인라인 상태",
			"type": "string",
			"required": false,
			"description": "정보상자 안에 틀을 넣고자 할 때 사용하며, 사용하면 제목 줄과 테두리를 없앱니다."
		},
		"title": {
			"label": "제목",
			"type": "string",
			"required": false,
			"description": "제목을 넣습니다. «no»를 입력하면 제목 줄이 사라집니다."
		},
		"title color": {
			"label": "제목 색",
			"type": "string",
			"required": false,
			"default": "#FFF 또는 #252525",
			"description": "제목의 색깔을 지정합니다. 기본값은 배경 색에 따라 검은색 또는 흰색으로 정해집니다.",
			"aliases": 
				"title-color"
			
		},
		"title bg color": {
			"label": "제목 배경 색",
			"type": "string",
			"required": false,
			"default": "#27404E",
			"description": "제목의 배경 색을 지정합니다.",
			"aliases": 
				"title-bg"
			
		},
		"collapsible": {
			"label": "숨김 가능 여부",
			"type": "string",
			"required": false,
			"description": "도표를 숨길 수 있는지의 여부를 지정합니다."
		},
		"collapse": {
			"label": "숨김 상태",
			"type": "string",
			"required": false,
			"description": "문서가 처음 보일 때 도표를 숨길지를 지정합니다. 기본 상태는 도표가 드러나며, 아무 값을 넣으면 도표가 숨겨집니다.",
			"aliases": 
				"collapsed"
			
		},
		"navbar": {
			"label": "틀 이름",
			"type": "string",
			"required": false,
			"description": "안내바 틀에 적용될 틀의 이름을 넣습니다.",
			"aliases": 
				"tnavbar"
			
		},
		"navbar pos": {
			"label": "안내바 위치",
			"type": "string",
			"required": false,
			"description": "안내바 틀의 위치를 지정합니다. 기본 상태는 제목 줄에 표시되며, «1»을 넣으면 제목 줄 아래에, «2»를 넣으면 하단에 표시됩니다."
		},
		"legend": {
			"label": "범례",
			"type": "wiki-page-name",
			"required": false,
			"default": "틀:노선도 설명",
			"description": "범례 링크의 별칭을 넣습니다. «bus», «canal», «footpath», «track» 등의 값을 넣을 수 있으며, «0»이나 «no»를 넣으면 범례 링크가 사라집니다."
		},
		"legend alt": {
			"label": "범례 링크 텍스트",
			"type": "string",
			"required": false,
			"default": "범례",
			"description": "‘범례’ 링크 위치에 다른 텍스트를 넣고 싶은 경우 사용합니다."
		},
		"float": {
			"label": "Floating state",
			"type": "string",
			"required": false,
			"default": "right",
			"description": "Floating state of the whole box: «right» by default; optionally «left» or «none»"
		},
		"bg": {
			"label": "Background color",
			"type": "string",
			"required": false,
			"default": "#F9F9F9",
			"description": "Background color of the whole map area"
		},
		"style": {
			"label": "CSS style values",
			"type": "string",
			"required": false,
			"description": "Additional CSS style definition of the whole infobox"
		},
		"top": {
			"label": "Top note",
			"type": "string",
			"required": false,
			"description": "Space for optional note or infobox above the map",
			"aliases": 
				"on top"
			
		},
		"footnote": {
			"label": "Bottom note",
			"type": "string",
			"required": false,
			"description": "Space for optional note or infobox below the map",
			"aliases": 
				"bottom"
			
		},
		"text-width": {
			"label": "Width of map text cell",
			"type": "string",
			"required": false,
			"description": "Extend the width of the map text cell so the collapsible section within the map does not break",
			"aliases": 
				"tw"
			
		},
		"map": {
			"label": "Map markups",
			"description": "Map data which uses specific markup/separators to load icon image and arrange the text in the uniform style",
			"required": true,
			"type": "string",
			"aliases": 
				"1"
			
		},
		"navbar mini": {
			"label": "Small navbar",
			"description": "If the navbar is not in default position, then this changes whether the navbar displays as \"V · T · E\" (default for navbar pos 1; values: «1», «y», «yes», «true») or \"This diagram: view · talk · edit\" (default for navbar pos 2; values: «0», «n», «no», «false»).",
			"type": "string"
		}
	},
	"format": "block",
	"paramOrder": 
		"inline",
		"title",
		"title color",
		"title bg color",
		"collapsible",
		"collapse",
		"navbar",
		"navbar pos",
		"navbar mini",
		"legend",
		"legend alt",
		"float",
		"bg",
		"style",
		"top",
		"footnote",
		"text-width",
		"map"
	
}

**분류**
이 틀은 이 틀이 부착된 문서에 아래의 분류를 적용합니다:

**같이 보기**
분류:철도 노선도 틀