ctanify - 클라우드 온라인

프로그램:

이름

ctanify - CTAN에 업로드할 패키지 준비

개요

정제하다 [--pkgname=현] [--[아니]자동] [--tdsonly=파일 사양 ...] [--[아니]단일화하다]
[--[아니]건너 뛰기] [--tdsdir=이름 ...] [--텍스=매크로_pkg] [--[아니]잘못하다] 파일 사양[=이름]
...

정제하다 [--도움]

정제하다 [--번역]

기술

청량하다 LaTeX 패키지를 배포하려는 개발자를 위한 것입니다.
CTAN(Comprehensive TeX Archive Network)을 통해 파일 이름 목록이 주어지면 청량하다
타르볼을 생성합니다( .tar.gz 파일)을 CTAN의 기본 구조로 배치된 파일과 함께 사용합니다.
tarball에는 ZIP(.지퍼) 배치된 모든 파일의 사본이 있는 파일
표준 TeX 디렉토리 구조(TDS)는 패키지를
TeX 라이브 배포.

옵션

청량하다 다음 명령줄 옵션을 허용합니다.

-h, --도움
기본 사용 정보를 출력하고 종료합니다.

-V, --번역
산출 청량하다의 버전 번호를 입력하고 종료합니다.

-p 현, --pkgname=현
패키지 이름을 명시적으로 지정하십시오. 보통, 청량하다 첫 번째 기본 이름을 사용합니다.
.ins or .다래끼 패키지 이름으로 나열된 파일. 패키지 이름은 기본 이름을 형성합니다.
타르볼의 청량하다 생성합니다.

--노오토
파일을 tarball에 자동으로 추가하지 마십시오. 보통, 청량하다 자동적으로
a에 언급된 모든 파일을 포함합니다. .ins 파일.

-t 파일 사양, --tdsonly=파일 사양
TDS에만 포함되도록 명령줄에 명명된 파일의 하위 집합을 지정합니다.
CTAN 패키지 디렉토리가 아닌 ZIP 파일. 와일드카드가 허용됩니다(인용되는 경우
필요), --tdsonly 동일한 명령줄에서 여러 번 사용할 수 있습니다.

명령줄에 하나 이상의 파일 이름을 지정해야 합니다. 청량하다 자동으로 배치
확장자를 기반으로 TDS 트리의 파일이지만 다음을 지정하여 재정의할 수 있습니다.
형식을 사용하여 명시적으로 대상 TDS 디렉토리 파일 사양=이름. 와일드카드가 허용됩니다.
filespec용(필요한 경우 인용).

추가 옵션

다음 옵션은 일반적인 사용에서는 거의 필요하지 않습니다. 그들은 제공됩니다
발생할 수 있는 특별한 상황을 위해.

-d 이름, --tdsdir=이름
CTAN용 타르볼을 생성하는 대신 패키지 TDS 트리를 루트로 생성하기만 하면 됩니다.
예배 규칙서 이름.

-T 매크로_pkg, --텍스=매크로_pkg
CTAN용으로 패키징되는 파일이 다음이 아닌 TeX 매크로 패키지를 대상으로 하는지 어설션
유액. 몇 가지 일반적인 예 매크로_pkg "일반", "일반" 및 "컨텍스트"입니다.

-노우, --no-unixify
줄 끝 문자를 Unix로 변환하는 대신 수정되지 않은 텍스트 파일 저장
형식(캐리지 리턴 문자가 없는 단일 줄 바꿈 문자)
CTAN은 Unix 형식의 줄 끝 문자가 포함된 모든 파일 수신을 선호합니다.

-녹, -- 건너뛰지 않음
힘 청량하다 Unix 숨겨진 파일, Emacs 백업 파일 및
CTAN이 수신을 싫어하는 버전 제어 메타데이터 파일.

-m, --오해하다
단일 파일이 포함된 디렉토리의 이름을 "misc"로 바꿉니다. (예를 들어 이름 바꾸기
"tex/latex/mypackage/mypackage.sty"에서 "tex/latex/misc/mypackage.sty"로.) 이것은
과거에는 일반적인 관행이었지만 지금은 권장하지 않습니다.

진단

"복사 실패 파일 이름 (아니 이러한 파일 or 예배 규칙서)"
이 메시지는 일반적으로 .ins 생성하는 파일 파일 이름 그러나 그것은
이미 실행되지 않은 텍스 or 유액 실제로 생산하기 위해 파일 이름. 청량하다 하지
자동으로 실행되지 않음 텍스 or 유액; 이것은 사용자가 수동으로 수행해야 합니다. 보다
자세한 내용은 "주의 사항"을 참조하십시오.

"수정 파일 이름 에 사용 유닉스 선 엔딩 (용도 --no-unixify 에 예방 이것)"
일관성을 위해 CTAN은 Unix 스타일의 줄 끝이 있는 모든 텍스트 파일을 저장합니다(단일
캐리지 리턴 문자가 없는 줄 바꿈 문자). 이러한 노력을 돕기 위해,
청량하다 Unix 스타일이 아닌 줄 끝을 자동으로 대체합니다. 앞의 단지
메시지는 사용자에게 다른 크기를 보더라도 놀라지 않아야 함을 알립니다.
파일 이름 tarball과 원본 파일 이름 디스크에(어떤 청량하다 못
수정). 원래 줄 끝을 보존해야 할 합당한 이유가 있는 경우(그리고 거기에
거의 없다), --no-unixify 방지하기 위해 옵션을 사용할 수 있습니다. 청량하다 변경에서
파일을 tarball에 저장할 때.

"을 제외한 파일 이름 (용도 -- 건너뛰지 않음 에 정력에도 유리합니다. 포함)"
청량하다 명령에 명시적으로 지정된 경우에도 일반적으로 파일을 무시합니다.
라인--CTAN은 수신하지 않는 것을 선호합니다. 여기에는 이름이 다음으로 시작하는 파일이 포함됩니다.
"." (Unix 숨김 파일), "로 끝남~" (Emacs 자동 백업) 또는
CVS or .svn 디렉토리(버전 관리 메타데이터 파일). 합당한 이유가 있다면
이러한 파일을 CTAN에 제출하면(거의 없습니다), -- 건너뛰지 않음 옵션을 사용할 수 있습니다
예방 청량하다 그들을 무시하는 것에서.

"CTAN은 PDF 문서만 있는 것을 선호합니다(re: 파일 이름)"
PDF 형식의 인기로 인해 CTAN은 많은 문서를 원합니다.
가능한 한 PDF로 배포합니다. 앞의 메시지는 사용자에게
가능한 경우 PDF가 포함된 PostScript 또는 DVI 문서. (청량하다 여전히 포함됩니다
tarball의 PostScript 및 DVI 문서; 앞의 메시지는 단지
정중 한 요청.)

"를 포함하지 않는 파일 이름 in 전에, TDS 나무 (알 수 없는 확대)"
청량하다 파일 확장자 테이블을 기반으로 TDS 트리에 파일을 배치합니다. 을 위한
예를 들어, 모두 .다래끼 파일은 tex/latex/패키지 이름. 면 청량하다 하지 않습니다
파일을 넣을 위치를 알면 어디에도 넣지 않습니다. 의 마지막 단락 참조
파일의 대상 위치를 명시적으로 지정하는 방법에 대한 설명은 "OPTIONS"
TDS 트리. 누락되는 일반적인 파일 확장자의 경우 청량하다's
테이블, 알림도 고려 청량하다아래에 표시된 주소의 의 작성자
"작가".

사용 예

이 어플리케이션에는 XNUMXµm 및 XNUMXµm 파장에서 최대 XNUMXW의 평균 출력을 제공하는 공통의 케이스
일반적으로 필요한 것은 말하기만 하면 됩니다. 청량하다 의 이름 .ins 파일 (또는 .다래끼 경우
패키지는 DocStrip을 사용하지 않음) 및 미리 빌드된 설명서(있는 경우):

$ ctanify mypackage.ins mypackage.pdf 읽어보기

490347 mypackage.tar.gz

1771 마이패키지/README
15453 mypackage/mypackage.dtx
1957 mypackage/mypackage.ins
277683 mypackage/mypackage.pdf
246935 mypackage.tds.zip

1771 문서/라텍스/mypackage/README
277683 doc/latex/mypackage/mypackage.pdf
15453 소스/라텍스/mypackage/mypackage.dtx
1957 소스/라텍스/mypackage/mypackage.ins
1725 tex/라텍스/mypackage/mypackage.sty

청량하다 결과 tarball, 그 안에 있는 각 파일 및 각 파일의 크기를 바이트 단위로 출력합니다.
포함된 ZIP 파일 내의 파일입니다. 앞의 예에서 어떻게 청량하다
다음 작업을 모두 자동으로 수행합니다.

· 포함 mypackage.dtx (파싱으로 발견 mypackage.ins) 둘 다에서 내 패키지
디렉토리 및 ZIP 파일,

· 포함 mypackage.sty (파싱으로 발견 mypackage.ins) ZIP 파일에 있지만
생성된 파일입니다. 내 패키지 디렉토리, 그리고

· 모든 파일을 적절한 TDS 디렉토리(문서, 소스, 기본
패키지) ZIP 파일 내에 있습니다.

동등한 것을 수동으로 생성하는 데 필요한 것을 고려하십시오. mypackage.tar.gz 파일.
청량하다 확실히 더 간단하고 빠른 대안입니다.

Advnaced 용법
청량하다 PostScript 파일이 문서라고 가정하므로 다음 위치에 저장합니다.
문서/라텍스/패키지 이름/ ZIP 파일 내의 TDS 트리에서. 그러나
LaTeX 패키지는 일련의 PostScript 파일을 사용하여 제어합니다. dvips의 출력. 이 경우,
청량하다 해당 PostScript 파일을 패키지 디렉토리에 포함하도록 지시해야 합니다.
문서 디렉토리.

$ ctanify mypackage.ins "mypackage*.ps=tex/latex/mypackage"

onworks.net 서비스를 사용하여 온라인으로 ctanify 사용