Tufte-css: これへの値下げ？

Pandocには構築用のテンプレートが用意されているため、Tuftepandocテンプレートの作成は簡単です。

@langfordは、Pandoc用のTufteテンプレートがすでに存在することが判明しましたください： //github.com/daveliepmann/tufte-css/issues/30#issuecomment- 128718117

@ xHN35RQ少し調べてみると、pandocテンプレートはこの機能にとって間違った方法のようです。テンプレートには$body$文字列が与えられ、その前後にテキストを配置することをほぼ期待しており、そうではないようです。マークダウンから生成されたテキストを実際に操作することを目的としています。 Luaで作成できるpandocカスタムライター（hallelujah）を使用します。 サイドノートを実装し、 articleタグを追加するだけの最低限のカスタムライターを作成しました。要点を参照してください。 tufte-cssを書き続けて、提供されているすべての機能を含めるように、これを拡張したいと思っています。理想的には、pandocマークダウンやそのリーダーについて何も変更する必要はありません。

（完全を期すために、pandocマークダウンからtufte-css対応のHTMLを完全に生成するために最終的に必要になる可能性があるものとして、 pandocフィルターについて言及する場合がありますが、おそらく非常にトリッキーな場合に限ります。フィルターは、ASTがカスタムライターに渡される前にASTを操作します。 。tufte-cssスタイルのサイドノートを作成する適切な場所は、フィルターとしてではなく、カスタムライターでした。）

@fasihaお疲れ様でした。 あなたはここで有望なスタートを切りました。 ：+1：

Markdownにtufte-css_sections_に相当する、つまり段落と見出しのグループ化がすぐに利用できるとは思いません。 しかし、私はセクションのアイデアが好きだと思います。ドキュメント編成のレベルを上げることは、将来的に役立つと思います。

Markdownのセクションをどのように示すことができるかコミュニティからの提案はありますか？

@fasiha見出し要素とすべての段落要素を次の見出し要素まで<section> （またはいくつかのカスタム<div> ）タグでラップし、これに目的のcssを適用しますか？

@vypで計量していただきありがとうございます。 tufte-cssのフロントページを読んだところ、 sectionは複数の見出し、または見出しのない段落をキャプチャできます。 つまり、それは単なる見出しとコンテンツのコンテナではありません。 私のドキュメントでは、今のところMarkdownに生のHTMLとして<section>を埋め込んでいます。このため、生のHTMLを受け入れることができると思います。

@fasihaああ、ごめんなさい、あなたは正しいです。 セクションは「テキストと見出しの論理的なグループ化」として定義されているため、人間の入力なしにドキュメント内のセクションが正確に何であるかを判断することは不可能です（つまり、実際にセクションをセマンティック情報としてマークアップするのと同じように、アスタリスクまたはアンダースコアで強調）。 そして、はい、私はこれらの「セクション」の既存の構文をマークダウンフレーバーで認識していないので、良いキャッチです。

この場合、生の<section>タグを使用するのが最善の方法です（独自のマークダウンのような構文を定義し、パーサーを作成する以外）。

もう1つの方法は、tufteが「セクション見出し」にh2を使用すると言っているという事実を使用することです。したがって、「セクション」はh2タグとして定義でき、次のh2タグまでのすべてを定義できます。 しかし、これがタフテの作者が意図したものであるかどうかはわかりません。

H2要素は、セクション境界の信頼できるソースではありません。 たとえば、一部のドキュメントでは、代わりに「ニューソート」スパンを使用しています。 私は他のバリエーションが野生で出現すると確信しています。

8 AGU 2015年、23：49で、VYP [email protected]書きました：

@fasihaああ、ごめんなさい、あなたは正しいです。 セクションは「テキストと見出しの論理的なグループ化」として定義されているため、人間の入力なしにドキュメント内のセクションが正確に何であるかを判断することは不可能です（つまり、実際にセクションをセマンティック情報としてマークアップするのと同じように、アスタリスクまたはアンダースコアで強調）。 そして、はい、私はこれらの「セクション」の既存の構文をマークダウンフレーバーで認識していないので、良いキャッチです。

生を使用する

この場合、タグは可能な限り最善の方法です（独自のマークダウンのような構文を定義し、パーサーを作成する以外）。

もう1つの方法は、tufteが「セクション見出し」にh2を使用すると言っているという事実を使用することです。したがって、「セクション」はh2タグとして定義でき、次のh2タグまでのすべてを定義できます。 しかし、これがタフテの作者が意図したものであるかどうかはわかりません。

—
このメールに直接返信するか、GitHubで表示してください。

誰かがマークダウンで<section>タグを使用することを避けたいのであれば、 <hr>似たいくつかの構文を実装するのは難しいことではないかもしれません。 <hr>の構文は、基本的に「1行に3つ以上のハイフン、アスタリスク、またはアンダースコアを単独で使用する」です。 したがって、たとえば、「セクション」の境界を「3つ以上の等号」（または任意の記号）として任意に定義し、pandocフィルタを使用して、これらの段落の各カップル間のすべてを等号のみでラップできます。

「等号の線」だけを選択したのは、これがプレーンテキストでセクションを分割するのがどのように見えるかを推測するためです。 また、pandocマークダウンはこれを段落としてのみ解析するため、フィルターはすべての段落に等号しかないかどうかを確認できます。等号のみで構成されている場合は、これがセクション境界の一部であると想定してください。

みなさん、こんにちは（そして、このスレッドを教えてくれた@daveliepmannに感謝します）。 私がTufte.cssを使用し（そのためにみんなに感謝します）、マークダウン、d3、およびTufteレイアウトを統合することを目的とした私の

reStructuredTextは、ここで必要な種類の注釈に対してMarkdownよりも受け入れやすいでしょうか？

@coppeliaMLAグラスアイについて言及してくれてありがとう、それは素晴らしい仕事です。

@rbcarson私はOPではありませんが、質問がここにいるすべての人に向けられていて、私の意見が必要な場合、私は個人的に再構成された

したがって、何年にもわたって、「マークダウン」に詰め込むことができる構文は他にもたくさんあります。それは、プレーンテキスト形式で読み取ることができるはずだからです。 サイドノートをプレーンテキストで視覚的にどのように伝えますか？ それにもかかわらず、pandocの拡張マークダウンはこの点で本当に良い仕事をしたと思います。

したがって、restructuredtextには、ディレクティブなどと呼ばれるものがあり、特定のタイプのデータの構文（または何か？）を構築できると思いますか？ そうだとすれば、そうです、おそらくここでは再構築されたテキストの方が適していると思います。 しかし、私が言ったように、私はそれについてあまり経験がないので、これ以上あなたを助けることはできません。

restructuredTextは、マークダウンですでに文書化されているプロジェクトである私の目的には役に立たないでしょう

2015年8月17日には、午前4時24分AMで、VYP [email protected]書きました：

@coppeliaMLAグラスアイについて言及してくれてありがとう、それは素晴らしい仕事です。

@rbcarson私はOPではありませんが、質問がここにいるすべての人に向けられていて、私の意見が必要な場合、私は個人的に再構成された

したがって、何年にもわたって、「マークダウン」に詰め込むことができる構文は他にもたくさんあります。それは、プレーンテキスト形式で読み取ることができるはずだからです。 サイドノートをプレーンテキストで視覚的にどのように伝えますか？ それにもかかわらず、pandocの拡張マークダウンはこの点で本当に良い仕事をしたと思います。

したがって、restructuredtextには、ディレクティブなどと呼ばれるものがあり、特定のタイプのデータの構文（または何か？）を構築できると思いますか？ そうだとすれば、そうです、おそらくここでは再構築されたテキストの方が適していると思います。 しかし、私が言ったように、私はそれについてあまり経験がないので、これ以上あなたを助けることはできません。

—
このメールに直接返信するか、GitHubで表示してください。

@coppeliaMLAは非常に興味深いです！：pandocを使用して特別なタグ付きのHTMLを出力し、次に別のプログラムを使用して特別なタグをJavascriptとHTMLに展開します。 私のアプローチは、BeautifulSoup解析の代わりにPandoc ASTを使用して、Luaでglasseye.pyを効果的に実行し、特別なタグを使用するPandocカスタムライターを作成すること

@fasihaありがとう。 あなたのやり方はもっと効率的に聞こえます、そして私はおそらく私が最終的にその方向に向かうかもしれないと思います。 簡単なプロトタイプを作成できるので、Pythonを選びました。 しかし、あなたが言うように、たくさんのドキュメントで実験することは最良の方法を磨くでしょう。 私はそれが私をどこに連れて行くかを見るために私の日々の仕事のできるだけ多くのためにそれを使うことを計画しています。 あなたがそれを試してみることができれば素晴らしいでしょう。 それがどうなるか聞くのが大好きです！

＃31および＃58も参照してください

価値があるものについて：Markdownでサイドノートを書く問題を解決するためにtufte-pandoc-cssをまとめました。 これは、私が作成したpandoc-sidenoteというカスタムPandocフィルターの使用方法の単なるショーケースです。

実際の動作を確認するには：

• PandocフレーバーのMarkdownでの再実装tufte-css / index.html
• シンタックスハイライトされたコードブロックなど、他のいくつか

@jezかっこいい！ これを回転させるプロジェクトを見つけることができるかどうかを確認します。

Googleでこのスレッドを見つけました

皆さんは、マークダウンをTufte-CSSvíaXSLTに変換する

@vieiroうわーこれはいいです。 素晴らしい仕事👍🏻