Markowik 구글 코드 위키에 마크 다운 형식의 텍스트로 변환하는 파이썬 응용 프로그램입니다.
Markowik는 구글 코드 위키 (GCW) 상응하는 대부분의 마크 다운 구조로 변환 할 수 있습니다. 대신 지원되는 모든 변환을 나열하는, Markowik의 테스트 스위트 및 쇼 케이스에서 참조하시기 바랍니다.
설치
실행
markowik를 설치 PIP
나 :
easy_install을 markowik
기부에서 설명한대로 설치하지 않고 Markowik를 사용할 수 있습니다.
명령 줄 사용
도움말 출력에서 :
사용 : markowik [-h] [--mx [MX [MX ...]]] [--image - baseurl의 URL]
& NBSP; - HTML - 이미지] [--encoding ENCODING] [--quiet]
& NBSP; INFILE [OUTFILE]
Google 코드 위키에 마크 다운을 변환합니다.
위치 인수 :
& NBSP; INFILE 인하 파일
& NBSP; OUTFILE 위키 파일 (기본값 : 표준 출력)
선택적 인수 :
& NBSP; -h이 도움말 메시지와 출구를 표시 --help
& NBSP; - MX [MX [MX ...]] 인하 확장 활성화
& NBSP; - 이미지 baseurl의 URL 기본 URL은 상대적으로 이미지 위치에 붙이는
& NBSP; - HTML - 이미지는 항상 이미지의 HTML을 사용
& NBSP; - 입력과 출력의 인코딩 인코딩 인코딩 (기본 : UTF8)
& NBSP; - 조용한 비활성화 정보 메시지
마크 다운 확장은 개별 확장이 공백으로 구분해야합니다 것을 제외하고, 마찬가지로 파이썬 마크 다운 (PyMD) 명령 행 도구로 제공 될 수있다 :
INPUT --mx 테이블을 markowik def_list
현재 지원 (예 : 테스트) 확장 약식, 테이블 및 def_list 있습니다. 다른 확장은 일반적으로 너무 작업을해야하지만, 변환 된 위키 텍스트에 예기치 않은 결과를 얻을 수 있습니다.
옵션 --html-이미지와 직결 된 제한 사항에서 아래의 설명을 참조하십시오.
프로그래밍 사용
Markowik 파이썬으로 구현된다. markowik 모듈은 함수 이름 변환을 제공합니다. 의미는 (키워드 인수가 줄 옵션을 명령에 해당) 명령 줄 인터페이스와 유사하다. 여기에 짧은 사용 예이다 :
>>> 수입 markowik
>>> markowik.convert ( "일부 * 인하의 * 텍스트 ...", MX = [ '테이블'])
u'Some _markdown_ 텍스트 ... '
페이지하는 pragma
GCW 페이지 프라그는 PyMD 메타 확장에 의해 정의 된 형식의 메타 데이터로서 마크 다운 원본 파일에 설정 될 수있다 :
>>> SRC = "" "요약 : 페이지 요약
... 레이블 : 일부, 레이블
...
... 여기 * * 페이지를 시작합니다 ..
... "" "
>>> 인쇄 markowik.convert (SRC, MX = [ '메타'])
#summary 페이지 요약
일부 레이블을 #labels
여기에 _page_을 시작합니다 ..
메타 확장 페이지 프라그를 인식하지 못하는 경우 기본 Markowik에 의해 즉, 명시 적으로 설정해야합니다
이 릴리스의 새로운 기능 무엇 :.
이 버전 0.1.1의 새로운 기능 :
이 문서를 개선.
마이너 수정.
이 요구 사항 :
이 파이썬
이 제한 사항 :
이 GCW가 마크 다운에서 가능한 모든 마크 업을 표현할 수 없습니다. 이 마크 다운 소스 파일을 염두에 다음과 같은 제한으로 작성해야 의미합니다.
링크 및 이미지의 URL을 :
링크 나 이미지 소스에 사용되는 URL은 절대해야하고 GCW 인식 얻을 수있는 특정 프로토콜이 있어야합니다. 특히, 모든 URL은 http : //로 시작해야합니다, HTTPS : // 또는 ftp : //. 는 이러한 요구 사항과 일치하지 URL을 발견하면 Markowik 변환을 중단합니다.
링크 이름에 Typefacing :
GCW은 링크 이름 typefacing을 지원하지 않습니다. 예를 들어 GCW은 [http://foo.com가 _Foo_] 말 그대로, _Foo_로 IE에서 링크 이름을 렌더링합니다. 그러나, GCW는 HTML 링크, 즉 & LT에서 typefacing을 인식; HREF = & quot; HTTP : //foo.com" 한다 _Foo_ 및 LT; /한다 적절하게 강조되고있다. [* 푸 *]와 같은 중첩 된 typefacing이 이유 마크 다운 링크의 경우 (http://foo.com) HTML 링크로 변환됩니다. 그 결과, 역 따옴표 사용 GCW에서 탈출해야하는 특정 특수 문자를 링크 라벨 (`) 마커는 HTML 링크가 발생합니다.
중첩 된 단락 :
GCW 정말 (목록 또는 blockquotes에서 예) 여러 중첩 된 단락을 지원하지 않습니다. Markowik는 & LT로 구분하여 여러 개의 중첩 된 단락을 시뮬레이션; BR /한다 (이 시각적으로 모방 단락하지만 중첩 환경을 파괴하지 않습니다).
이미지 :
마크 다운 이미지에 대한 대체 텍스트와 제목을 표현 할 수 있습니다. GCW의 이미지 구문은이 기능을 지원하지 않습니다. 이러한 텍스트를 보존 할 수있는 유일한 방법은 일반 HTML 및 LT를 사용하는 것; IMG한다 태그. 옵션 --html-이미지는이 문제를 해결 할 수 있습니다.
또 다른 문제는 GCW 이미지 URL을 이미지 파일 형식 확장자로 끝날 것으로 예상하고 있다는 것입니다. 필요한 경우 인스턴스 http://foo.bar/image이 http://foo.bar/image?x=x.png로 변경되었습니다 Markowik 인공 이미지 확장을 추가합니다.
요약 :
GCW는 약어에 대한 마크 업이 없다 않으며 HTML 태그 & LT를 지원하지 않습니다; 약식있다 ;. Markowik는 내지 & 약어로 변환; 스팬한다 (물론 제한된 방식으로) 모방 약어의 -elements 종류.
HTML :
무순 소스에서 발생하는 상관은 보통 HTML (스팬 레벨 태그의 내용을 제외하고)에 그대로 GCW 끝난다. 이 마크 다운 소스는 GCW가 지원하는 HTML을 포함해야 의미합니다. 또 다른 의미는 일반 HTML 태그에 사용되는 URL을 GCW 호환성을 확인하지 않습니다 것입니다. 즉 : 원시 HTML을 사용할 때 당신은 당신의 자신의있다!
댓글을 찾을 수 없습니다