Markdoc

Markdoc는 기술 문서 관리에 맞도록되어 있지만, 목적의 범위에 사용할 수 있습니다. Markdoc 몇 가지 주목할만한 판매 포인트가 있습니다 :
* 위키는 일반 텍스트 파일로 완벽하게 구성되어 있습니다, 그래서 당신은 쉽게 버전 제어를 넣을 수 있습니다.
* 위키는 HTTP 서버 타르볼로 배포 또는 게재 할 수 있습니다 독립 HTML 디렉토리로 컴파일합니다.
* 당신은 선택적으로 모든 렌더링 된 페이지와 함께 HTML 디렉토리로 컴파일됩니다 정적 미디어를 포함 할 수 있습니다.
* Markdoc 컴파일 위키를 제공하기위한 완벽한 기능을 순수 파이썬 WSGI 응용 프로그램 및 HTTP 서버와 함께 제공됩니다.
* 당신은 등등 Pygments 기반 코드 강조, 정의 목록의 확장 구문, 목차 생성, 같은 마크 다운 확장, 다양한와 위키를 렌더링 할 수 있습니다.
* 당신은 완전히 위키는 전체 HTML 문서로 렌더링 마크 다운을 변환하는 데 사용 Jinja2 템플릿을 편집하여 렌더링하는 방법을 사용자 정의 할 수 있습니다.
빠른 시작
설치 :
#! / 빈 / bash는
HG 클론 SSH : //hg@bitbucket.org/zacharyvoase/markdoc
CD의 markdoc /
-r의 요구 사항을 설치 PIP
파이썬 설치 setup.py
위키 만들기
#! / 빈 / bash는
markdoc 내 - 위키 초기화하기
CD 내 - 위키 /
정력 위키 / somefile.md
# ... 일부 문서를 작성 ...
markdoc 빌드
markdoc 봉사
# .. 오픈에 http : // localhost를 : 브라우저에서 8008 / ...
레이아웃
Markdoc 위키에는 다음과 같은 기본 레이아웃을 가지고 :
WIKI_ROOT /
| - .HTML /
| - .templates /
| - .TMP /
| - 정적 /
| - 위키 /
`- markdoc.yaml
그들은 임시 파일을 포함하기 때문에 .HTML / 및 .TMP은 / 디렉토리는, 어떤 VCS에서 제외되어야한다.
/ 위키 / layout.md 다양한 서브 디렉토리의 역할에 대한 자세한 내용은 문서의 레이아웃 문서를 참조하십시오

요구 사항 :.

파이썬
삐악 삐악 울다
rsync를