#alias "KTUG 사설 저장소", KTUG사설저장소

[[TableOfContents]]

== 목적 ==
 * KTUG 사설저장소는 한국어 사용자를 위한 패키지로서 TeX Live를 통하여 제공되지 않는 것을 추가적으로 설치하여 사용할 수 있게 하려는 목적으로 운영된다.
== 설치전 주의 사항 ==
 * KTUG 사설 저장소는 TeXLive를 설치후 TeXLive에서 제공되지 않는 패키지를 제공하지만, 일반적인 사용자라면 굳이 설치할 필요는 없다. 아래에 있는 내용이 무엇인지 모른다면 굳이 설치할 필요는 없다.
== 설치 가능한 패키지 ==
아래의 목록은 2017년 9월 현재 기준으로 작성되었으며, ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])는 github에 올라간 패키지들의 묶음이다.

 * '''arara-rules-ko''' 한글 사용자를 위한 arara rules 추가
 * '''graphicsonthefly''' Import and include graphics from url ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''hangulfontset''' 간단하게 한글 폰트 설정하기 ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''hanjacnt''' 한자와 한글 카운터 수식자를 제공하는 hanjacnt를 완전히 다시 쓰고 기능을 확장하였다. 숫자를 한자와 한글 표기로 표현한다. ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''hcr-lvt''' [함초롬LVT] 트루타입 폰트
 * '''hnja2hngl''' 한자로 입력된 텍스트에 대하여 대응하는 한글 음을 붙여준다. ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''ifpxltex''' 현재 사용 중인 엔진을 확인 ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''jiwonlipsum''' Lorem ipsum for Korean ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''ko-blacklist''' luatex culprit font blacklist
 * '''kocircnum''' Typesetting circled integer ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''kotex-euc''' [EUC-KR] 한글 문서 작성
 * '''kotex-midkor''' pdfTeX을 위한 옛한글 처리
 * '''kotex-sections''' 옛날 HLaTeX 절표제 ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''ksbaduk''' Drawing Baduk (go) Diagrams with TikZ ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''ksmisc''' ksjosaref, kslinematters, ksmisc, kstextks, preparefont ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''kswrapfig''' 그림과 텍스트 사이의 간격과 위치를 조절하는 옵션을 제공 ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''ksforloop''' for-loop
 * '''ksruby''' xelatex에서 루비문자 사용
 * '''ktugbin''' (Windows) 윈도우즈 사용자를 위한 ko.TeX Live 추가 실행 파일
 * '''nanumbaruntype1''' 나눔바른고딕 type1
 * '''nanumttf''' 나눔명조/고딕 트루타입
 * '''ob-chapstyles''' A few chapter styles for oblivoir class ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''ob-mathleading''' amsmath 패키지의 여러 줄 수식 환경의 행 간격을 본문의 행 간격과는 무관하게 일정하게 고정하거나 임의로 변경할 수 있도록 하는 패키지
 * '''readhanja''' A LuaLaTeX package for semi-automatized typesetting of Hanja-to-Hangul sound values. ([[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]])
 * '''texworks-config''' (Windows) 윈도우즈 사용자를 위한 ko.TeX Live의 TeXworks 설정
 * '''unfonts-base-type1''' 은 글꼴 (type1)
 * '''unfonts-other-type1''' 은 글꼴 (type1)
== 저장소 활용 ==
=== 저장소의 등록과 관리 ===
TeX Live의 tlmgr 유틸리티를 이용하여 저장소를 등록, 관리할 수 있다.
 다음 절차에서 <sudo> 부분은, Windows에서는 생략, Mac OS X에서는 sudo, 리눅스에서는 sudo -i 로 대체한다.

 1. ["TeX Live"] [ko.TeX] 저장소를 다음과 같이 하여 추가한다.{{{#!sh
# <sudo> tlmgr repository add http://ftp.ktug.org/KTUG/texlive/tlnet/ ktug}}}
 1. pinning을 추가한다. {{{#!sh
# <sudo> tlmgr pinning add ktug "*"
}}}
 1. 필요한 패키지를 설치한다.{{{#!sh
# <sudo> tlmgr install unfonts-base-type1}}}
 1. 저장소가 등록되어 있으면 업데이트는 다음 명령으로 함께 (자동으로) 이루어진다. {{{#!sh
# <sudo> tlmgr update --all --self
}}}
=== 패키지 정보 보기 ===
예를 들어 kotex-euc 패키지의 정보를 보려면(패키지를 설치하지 않은 상태에서도 확인 가능) {{{
# tlmgr info kotex-euc
}}}
결과는 다음과 같다.{{{
package:     kotex-euc
repository:  ktug/100
category:    Package
shortdesc:   ko.TeX macros for EUC-KR encoding
installed:   No
sizes:       src: 13k, doc: 5149k, run: 321k, bin: 117k
relocatable: No
}}}
=== 저장소의 제거 ===
 1. 패키지를 제거하려면 {{{#!sh
# <sudo> tlmgr remove unfonts-base-type1
}}}
 1. 저장소를 제거하려면 {{{#!sh
# <sudo> tlmgr repository remove ktug}}}
{{{#!sh
# <sudo> rm -f /usr/local/texlive/texmf-local/tlpkg/pinning.txt}}}

=== pinning 확인/제거/추가 ===
 1. pinning 확인 {{{#!sh
# tlmgr pinning show
}}}
 attachment:pinningshow.png

 1. pinning 제거 {{{#!sh
# <sudo> tlmgr pinning remove ktug --all}}}
{{{#!sh
# <sudo> tlmgr pinning remove kotex --all  (이전에 설정한 kotex:*이 남아 있을 때)}}}

 1. pinning 추가 {{{#!sh
# <sudo> tlmgr pinning add ktug "*"
}}}

      * 유닉스 계열 운영체제(맥, 리눅스) 따옴표로 감싸는 것에 주의!
=== tar.xz 파일로 설치 ===
[[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]] 혹은 [[http://ftp.ktug.org/KTUG/texlive/tlnet/archive/|ftp]] 에서 직접 다운받은 tar.xz 압축파일로 설치를 할 경우, 파일이 있는 경로에서 다음을 실행하면 된다. {{{#!sh
# <sudo> tlmgr install --file jiwonlipsum.tar.xz  (패키지 설치)}}}
{{{#!sh
# <sudo> tlmgr install --file jiwonlipsum.doc.tar.xz  (패키지 documentation 설치)}}}

== 연혁 ==
 * 2008년부터 현재까지 KTUG 서버를 통하여 ["ko.TeX"] 관련 패키지를 제공해왔다. 
 * 2013년 11월 이후, ["ko.TeX"]의 주요 패키지는 CTAN, ["TeX Live"], MiKTeX을 통하여 배포된다.
 * 사설저장소에는 한국어 사용자를 위한 추가적 보조적 패키지만 존재한다.
 * 2017년 07월부터는 단일 압축파일로 제공되는 패키지들의 경우 따로 [[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]]에서도 받을 수 있도록 하였다.

== 참고 ==
 * KTUG 게시물 2014.04.25. http://www.ktug.org/xe/index.php?document_srl=181846
 * KTUG 사설저장소는 ''tlmgr이 있는 TeX Live'' 시스템에서 동작한다.
 * MiKTeX 사용자는 이 사설저장소를 이용할 수 없다.
 
== 팁 ==
 * KTUG Private Repository의 모든 패키지를 한꺼번에 모두 설치하려면? {{{
$ tlmgr install arara-rules-ko graphicsonthefly hangulfontset \
hanjacnt hcr-lvt hnja2hngl ifpxltex jiwonlipsum \
ko-blacklist kocircnum kotex-euc kotex-midkor kotex-sections \
ksbaduk ksforloop ksmisc kswrapfig nanumbaruntype1 \
nanumttf ob-chapstyles readhanja unfonts-base-type1 unfonts-other-type1 \
texworks-config ktugbin ksruby
}}}
  마지막의 texworks-config와 ktugbin은 Windows에서만 필요하다.

== KTUG PR browser ==
KTUG Private Repository에 등재된 패키지들에 관한 간단한 설명 및 documentation을 [[https://koreantug.github.io/ktugpr-browser|KTUG PR browser]]에서 웹에서 볼 수 있다. CTAN에서와 같이, 각각의 저자에 대한 정보도 함께 확인할 수 있다. tar.xz 형식의 패키지들만을 등재했으므로 폰트 관련 패키지들은 아직 등재되지 않은 상태이다.