Tufte-css: 이에 대한 마크다운?

Pandoc은 구축할 템플릿 을 제공하므로 Tufte pandoc 템플릿을 만드는 것은 간단해야 합니다.

@langford 는 것으로 나타났습니다. Markdown/Multi-Markdown을 Tufte 스타일로 변환하는 방법에 대한 자세한 내용은 여기 내 의견을 참조 하세요 .

@xHN35RQ 를 조금 $body$ 문자열이 주어지고 그 앞뒤에 텍스트를 넣을 것으로 거의 예상하고 있습니다. 마크다운에서 생성된 텍스트를 실제로 조작하기 위한 것입니다. 루아에서 쓸 수 있는(할렐루야) pandoc 커스텀 라이터 를 사용할 것입니다. 나는 사이드노트를 구현하고 article 태그를 추가하는 베어본 커스텀 라이터를 작성했습니다: gist 참조 . 제공되는 모든 기능을 포함하도록 tufte-css를 계속 작성하면서 이 기능을 확장하기를 희망합니다.

(완전함을 위해 pandoc 마크다운에서 tufte-css 지원 HTML을 완전히 생성하는 데 결국 필요할 수 있는 것으로 pandoc 필터 를 언급할 수 있지만 아마도 매우 까다로운 작업에만 해당됩니다. 필터는 AST가 사용자 정의 작성자에게 제공되기 전에 AST를 조작합니다. . tufte-css 스타일의 사이드노트를 작성하는 올바른 위치는 필터가 아니라 사용자 정의 작성기였습니다.)

@fasiha 잘했습니다. 당신은 여기에서 유망한 시작을 했습니다. :+1:

Markdown에서 tufte-css _sections_와 같이 쉽게 사용할 수 있는 항목이 없다고 생각합니다. 즉, 단락과 제목의 그룹화입니다. 하지만 섹션이라는 아이디어가 마음에 든다고 생각합니다. 문서 구성 수준이 더 높아지면 앞으로 도움이 될 것입니다.

Markdown에서 섹션을 표시하는 방법에 대한 커뮤니티의 제안이 있습니까?

@fasiha 제목 요소와 모든 단락 요소를 다음 제목 요소까지 가져오는 필터는 어떻습니까? 그런 다음 이것을 <section> (또는 일부 사용자 정의 <div> ) 태그로 감싸고 원하는 CSS를 여기에 적용하시겠습니까?

@vyp에 무게를 달아주셔서 감사합니다. tufte-css 첫 페이지에서 section 는 두 개 이상의 제목 또는 제목이 없는 단락을 캡처할 수 있습니다. 즉, 제목 및 내용 컨테이너가 아닙니다. 내 문서에서 지금은 <section> 를 원시 HTML로 Markdown에 포함하고 있습니다. 이 경우 원시 HTML을 허용할 수 있다고 생각합니다.

@fasiha 아 죄송합니다 맞습니다. 섹션은 "텍스트와 제목의 논리적 그룹화"로 정의되기 때문에 사람의 입력 없이 문서에서 섹션이 정확히 무엇인지 결정하는 것은 불가능합니다. 별표 또는 밑줄로 강조). 그리고 예, 마크다운 맛에서 이러한 "섹션"에 대한 기존 구문을 알지 못하므로 잘 잡습니다.

원시 <section> 태그를 사용하는 것이 이 경우에 가능한 최선의 방법입니다(자신의 마크다운과 유사한 구문을 정의하고 이에 대한 파서를 작성하는 것 제외).

갈 또 다른 방법은 tufte가 "섹션 제목"에 대해 h2를 사용한다고 말하는 사실을 사용하는 것입니다. 따라서 "섹션"은 h2 태그 및 다음 h2 태그까지의 모든 것으로 정의될 수 있습니다. 그러나 이것이 tufte의 저자가 의도한 것인지 확실하지 않습니다.

H2 요소는 섹션 구분의 신뢰할 수 있는 소스가 아닙니다. 예를 들어, 일부 문서는 대신 "newthought" 범위를 사용합니다. 나는 다른 변형이 야생에서 나타날 것이라고 확신합니다.

2015년 8월 8일 23:49에 vyp [email protected]이 다음과 같이 썼습니다.

@fasiha 아 죄송합니다 맞습니다. 섹션은 "텍스트와 제목의 논리적 그룹화"로 정의되기 때문에 사람의 입력 없이 문서에서 섹션이 정확히 무엇인지 결정하는 것은 불가능합니다. 별표 또는 밑줄로 강조). 그리고 예, 마크다운 맛에서 이러한 "섹션"에 대한 기존 구문을 알지 못하므로 잘 잡습니다.

원시 사용

태그는 이 경우에 할 수 있는 가장 좋은 방법입니다(자신의 마크다운과 유사한 구문을 정의하고 이에 대한 파서를 작성하는 것 제외).

갈 또 다른 방법은 tufte가 "섹션 제목"에 대해 h2를 사용한다고 말하는 사실을 사용하는 것입니다. 따라서 "섹션"은 h2 태그 및 다음 h2 태그까지의 모든 것으로 정의될 수 있습니다. 그러나 이것이 tufte의 저자가 의도한 것인지 확실하지 않습니다.

—
이 이메일에 직접 답장하거나 GitHub에서 확인하세요.

마크다운에 <section> 태그를 사용하지 않으려는 사람이 있으면 <hr> 와 유사한 구문을 구현하는 것이 어렵지 않을 수 있습니다. <hr> 의 구문은 기본적으로 "한 줄에 3개 이상의 하이픈, 별표 또는 밑줄"입니다. 예를 들어 "섹션" 경계를 "세 개 이상의 등호"(또는 원하는 대로)로 임의로 정의한 다음 판독 필터를 사용하여 이 단락의 각 쌍 사이의 모든 것을 등호로만 감쌀 수 있습니다.

나는 이것이 일반 텍스트로 섹션을 나누는 것이 _look_ 좋아할 것이라고 생각하기 때문에 "등호 라인"만을 선택했습니다. 그리고 pandoc 마크다운은 이것을 단락으로만 구문 분석하기 때문에 필터는 등호만 있는지 없는지 모든 단락을 검사할 수 있고 등호로만 구성된 경우 이것이 섹션 구분의 일부라고 가정합니다.

안녕하세요 (이 스레드를 알려준 @daveliepmann 에게 감사드립니다). 당신은 내가 Tufte.css를 사용했고(모든 사람에게 감사합니다) 마크다운, d3 및 Tufte 레이아웃을 통합하는 것을 목표로 하는 내

reStructuredText가 Markdown보다 여기에 필요한 주석 종류에 더 적합할까요?

@coppeliaMLA glasseye 를 언급

@rbcarson 저는 OP가 아니지만 질문이 여기 있는 모든 사람을 대상으로 하고 제 의견을 원하신다면 저는 개인적으로 재구성된

그래서 수년에 걸쳐 "마크다운"에 집어넣을 수 있는 다른 유형의 구문이 너무 많았습니다. 그 요점은 일반 텍스트 형식으로 읽을 수 있어야 한다는 것입니다. 일반 텍스트에서 사이드노트를 시각적으로 어떻게 전달합니까? 그럼에도 불구하고 나는 pandoc의 확장된 마크다운이 이와 관련하여 정말 좋은 일을 해냈다고 생각합니다.

그래서 재구성된 텍스트에는 특정 유형의 데이터에 대한 구문(또는 무엇인가?)을 구축할 수 있는 지시문이나 무언가가 있다고 생각합니다. 그런 경우라면, 예, 재구성된 텍스트가 여기에서 더 적합하다고 생각합니다. 하지만 말씀드린 것처럼 저는 경험이 많지 않기 때문에 더 이상 도움을 드릴 수 없습니다.

restructuredText는 이미 마크다운에 문서화된 프로젝트인 내 목적에는 쓸모가 없습니다.

2015년 8월 17일 오전 4시 24분에 vyp [email protected]이 다음과 같이 썼습니다.

@coppeliaMLA glasseye 를 언급

@rbcarson 저는 OP가 아니지만 질문이 여기 있는 모든 사람을 대상으로 하고 제 의견을 원하신다면 저는 개인적으로 재구성된

그래서 수년에 걸쳐 "마크다운"에 집어넣을 수 있는 다른 유형의 구문이 너무 많았습니다. 그 요점은 일반 텍스트 형식으로 읽을 수 있어야 한다는 것입니다. 일반 텍스트에서 사이드노트를 시각적으로 어떻게 전달합니까? 그럼에도 불구하고 나는 pandoc의 확장된 마크다운이 이와 관련하여 정말 좋은 일을 해냈다고 생각합니다.

그래서 재구성된 텍스트에는 특정 유형의 데이터에 대한 구문(또는 무엇인가?)을 구축할 수 있는 지시문이나 무언가가 있다고 생각합니다. 그런 경우라면, 예, 재구성된 텍스트가 여기에서 더 적합하다고 생각합니다. 하지만 말씀드린 것처럼 저는 경험이 많지 않기 때문에 더 이상 도움을 드릴 수 없습니다.

—
이 이메일에 직접 답장하거나 GitHub에서 확인하세요.

@coppeliaMLA 매우 흥미롭습니다!: pandoc을 사용하여 특수 태그가 있는 HTML을 출력한 다음 두 번째 단계로 다른 프로그램을 사용하여 특수 태그를 Javascript 및 HTML로 확장합니다. 내 접근 방식은 BeautifulSoup 구문 분석 대신 Pandoc AST를 사용하여 Lua에서 효과적으로 glasseye.py 를 수행하는 특수 태그를 사용하는 Pandoc 사용자 지정 작성기를 만드는 것이지만 glasseye가 기본적으로 제대로 작동하는 것처럼 보입니다. 나는 내 문서를 glasseye-ify하려고 노력하고 모든 문제에 대해 리포지토리에서 알려줄 것입니다. Pandoc 라이터에서 하기 힘든 일들이 후처리가 더 쉬울 수도 있고 그 반대일 수도 있지만 알아낼 수 있는 유일한 방법은 많은 문서를 작성하는 것입니다 :)

@fasiha 감사합니다. 당신의 방식이 더 효율적으로 들리고 결국에는 내가 그 방향으로 갈 수도 있을 것 같아요. 빠른 프로토타입을 만들 수 있는 파이썬을 선택했습니다. 그러나 당신이 말했듯이 많은 문서를 실험하는 것이 가장 좋은 방법을 연마할 것입니다. 가능한 한 많은 일상 업무에 사용할 계획입니다. 당신이 그것을 시도 할 수 있다면 좋을 것입니다. 어떻게 진행되는지 듣고 싶습니다!

#31 및 #58 참조

그만한 가치가 있습니다. Markdown에서 사이드 노트를 작성하는 문제를 해결하기 위해 tufte-pandoc-css 를 모았습니다. pandoc-sidenote 라는 사용자 지정 Pandoc 필터를 사용하는 방법을 보여줍니다.

작동을 보려면 다음을 수행하십시오.

• Pandoc-flavored Markdown의 tufte-css/index.html 재구현
• 구문 강조 코드 블록과 같은 다른 Pandoc 기능 의 데모입니다.

@jez 쿨! 나는 이것을 소용돌이 치는 프로젝트를 찾을 수 있는지 볼 것입니다.

방금 Google을 통해 이 스레드를 찾았습니다.

마크다운을 XSLT를 통해 Tufte-CSS로 변환하는 xmark를 살펴보고 싶을 수도 있습니다.

@vieiro 와우 멋지네요. 멋진 작품 👍🏻