GitHub 플레이 버드 마크 다운 파일 을 가져 와서 HTML로 렌더링하기 위한 명령 줄 유틸리티가 있는지 궁금합니다 .
웹 사이트 콘텐츠를 만들기 위해 GitHub 위키를 사용하고 있습니다. 서버에서 리포지토리를 복제 한 다음 일반 HTML로 처리하려고합니다. GitHub에 나타나는 것은 내 웹 사이트를 찾는 방법과 정확히 일치하는 것이 중요합니다. 또한와 함께 분리 된 블록을 사용하고 ~~~
싶습니다. 따라서 표준 Markdown 구문 만 사용하고 싶지 않습니다.
Node.js에 연결할 수 있다고 생각하는 JavaScript 라이브 미리보기를 조금 보았지만 더 이상 사용되지 않는다고 말합니다. 레드 카펫 저장소를 살펴 봤지만 명령 행 인터페이스가있는 것처럼 보이지 않습니다.
그러나 내 솔루션을 롤백했지만 여기에 다른 솔루션보다 분명히 좋은 솔루션은 없으므로 선택한 답변없이 질문을 남길 것입니다.
답변
파이썬으로 작은 CLI를 작성하고 GFM 지원을 추가했습니다. 그것은라고 그립 (Github의 추가 정보 인스턴트 미리보기) .
다음과 같이 설치하십시오.
$ pip install grip
그리고 그것을 사용하려면 간단히 :
$ grip
그런 다음 해당 위치에서 파일 localhost:5000
을 보려면 방문하십시오 readme.md
.
자신의 파일을 지정할 수도 있습니다.
$ grip CHANGES.md
그리고 포트를 변경하십시오 :
$ grip 8080
물론 GitHub-Flavored Markdown을 선택적으로 리포지토리 컨텍스트와 함께 렌더링하십시오.
$ grip --gfm --context=username/repo issue.md
주목할만한 특징 :
- 페이지를 GitHub에서와 같이 정확하게 렌더링합니다
- 울타리 블록
- 파이썬 API
- 링크 된 파일 사이를 탐색하십시오 (감사합니다, vladwing !)2.0에 추가 된
- 2.0에 추가 된 단일 파일 (감사, iliggio !)로 내보내기
- 신규 : 3.0 에서 읽기
stdin
및 내보내기stdout
이것이 누군가를 돕기를 바랍니다. 확인하십시오 .
답변
나는 GitHub 맛 Markdown에 대한 빠르고 쉬운 방법을 찾지 못했지만 약간 더 일반적인 버전을 찾았습니다 -Pandoc . Markdown, Rest, HTML 등을 포함하여 여러 형식으로 변환합니다.
또한 Makefile
모든 .md 파일을 .html로 변환하기 위해 ( 개발 , 마크 다운 및 Pandoc 의 예제 와 같이 )을 개발했습니다.
# 'Makefile'
MARKDOWN = pandoc --from gfm --to html --standalone
all: $(patsubst %.md,%.html,$(wildcard *.md)) Makefile
clean:
rm -f $(patsubst %.md,%.html,$(wildcard *.md))
rm -f *.bak *~
%.html: %.md
$(MARKDOWN) $< --output $@
답변
아마도 이것이 도움이 될 수 있습니다.
gem install github-markdown
문서가 없지만 골룸 에서 얻었습니다. 문서 . 보면 rubydoc.info 사용할 수있는 것처럼, 그것은 본다 :
require 'github/markdown'
puts GitHub::Markdown.render_gfm('your markdown string')
루비 코드에서. 스크립트로 쉽게 감싸서 명령 줄 유틸리티로 만들 수 있습니다.
#!/usr/bin/env ruby
# render.rb
require 'github/markdown'
puts GitHub::Markdown.render_gfm File.read(ARGV[0])
로 실행하십시오 ./render.rb path/to/my/markdown/file.md
. 이것은 소독없이 생산에 사용하기에 안전하지 않습니다.
답변
pip3 install --user markdown
python3 -m markdown readme.md > readme.html
GitHub 확장을 처리하지 않지만 아무것도 아닌 것보다 낫습니다. GitHub 추가를 처리하기 위해 모듈을 확장 할 수 있다고 생각합니다.
답변
아마 당신이 원하는 것은 아니지만 Node.js를 언급 한 이후 : GitHub에 커밋하기 전에 로컬 드라이브에서 GitHub Flavored Markdown 설명서를 미리 볼 수있는 좋은 도구를 찾을 수 없었으므로 오늘 Node.js를 기반으로 문서를 만들었습니다. HTTPS : //github.com/ypocat/gfms
따라서 귀하의 질문이 여전히 실제 인 경우 showdown.js를 위키에 재사용 할 수 있습니다. 그렇지 않다면 아마도 내가했던 것과 같은 문제에 직면 한 다른 사람들 이이 질문과 그 대답을 찾을 수 있습니다.
답변
터미널에서 README.md 파일을 읽으려면 다음을 사용하십시오.
pandoc README.md | lynx -stdin
Pandoc은이를 Lynx가 터미널에서 렌더링하는 HTML 형식으로 출력합니다.
그것은 잘 작동합니다 : 터미널을 채우고 바로 가기가 아래에 표시되어 있으며 스크롤 할 수 있으며 링크가 작동합니다!
글꼴 크기는 하나 뿐이지 만 색상 + 들여 쓰기 + 정렬이 그에 맞게 구성됩니다.
설치:
sudo apt-get install pandoc lynx