2017-01-23 1 views
1

GitHub에서 렌더링 한 마크 다운 문서에 외부 파일의 테이블을 포함시키는 우아한 방법이 있습니까?외부 파일에 포함 된 .md 문서의 테이블

내가 생각할 수있는

비 우아한 솔루션 :

  1. (이 사람이 정말 정말 추한)
  2. 사용 Rmarkdown과 (실 거예요 기본적으로 렌더링) R을 사용하여 인쇄 테이블
이미지로 포함

약간의 설명을 드리겠습니다. GitHub는 모든 하위 디렉토리에 자동으로 파일을 렌더링하기 때문에 GitHub에서 호스트하는 파일을 사용하고 있습니다.

나는 이러한 문서에 포함되어야하는 요약 테이블을 알고리즘으로 생성하고 있습니다. README.md 파일을 직접 수정하는 스크립트를 작성하고 싶지 않기 때문에 테이블을 외부 파일에서 읽을 수 있다면 더 우아 할 것입니다.

답변

2

markdown 내에 파일을 포함 할 방법이 없습니다. 그러므로 Github에 표시되거나 마크 다운 도구로 렌더링되는 마크 다운을 생성하려면 "전처리"단계가 필요합니다.

당신은 당신의 README.md이 뭔가를 추가 할 수 스크립팅 :

해결 방법 1 : 다음

<!-- TABLE_GENERATE_START --> 

| First Header | Second Header | 
| ------------- | ------------- | 
| Content Cell | Content Cell | 
| Content Cell | Content Cell | 

<!-- TABLE_GENERATE_END --> 

그리고는이 Github에서 지원 무엇

는 렌더링해야 할 것 a basic table layout입니다 외부 테이블을 가져 와서 github 형식과 일치하도록 다시 포맷하고 두 주석 사이에 넣는 스크립트.

해결책 2 : pandoc

Pandoc은 여러 가지 입력 및 출력을 갖는 문서 변환기 프레임 워크이다. 당신은 당신이 table.md

  • csv2table를 사용하여 인하 파일에

    1. 다시 포맷하면 테이블이 전에 가격 인하와 readme_header.mdreadme_footer.md을 만들 수 다른 도구를 배우고까지라면/테이블 후
    2. 는 세 가지를 병합 cat readme_header.md table.md readme_footer.md > REAME.md

    물론 두 가지 솔루션을 함께 사용할 수도 있습니다. 스크립트를 사용하여 table.md을 생성하고 cat을 입력하십시오.

  • +0

    다른 스크립트를 실행해야하므로 정확하게 원하는 것은 아닙니다. 그러나 makefile을 사용하면 고통스럽지 않을 것입니다. 나는 그것을 시도 할 것이라고 생각합니다. 감사! markdown 내의 다른 파일을 포함하는 –

    +0

    은 기본 마크 다운 형식으로 지원되지 않습니다. 자, github에는 markdown의 고유 한 풍미가 있습니다 (거기에 맛이 많이 * 있기 때문에), 그러나 이것은 테이블을 직접 지원하고 파일을 포함하지 않습니다. (https://help.github.com/categories/writing) – hansaplast

    +0

    @Slim : 답변에 가능성이있는 판도크를 추가했습니다. – hansaplast

    관련 문제