Tufte-css: Abschlag dafür?

Pandoc bietet Vorlagen, auf denen Sie aufbauen können, daher sollte das Erstellen einer Tufte-Pandoc-Vorlage einfach sein.

@langford stellt sich heraus, dass es bereits eine Tufte-Vorlage für Pandoc gibt, siehe meinen Kommentar hier für Details zum Konvertieren von Markdown/Multi-Markdown in Tufte-Styling: https://github.com/daveliepmann/tufte-css/issues/30#issuecomment - 128718117

@xHN35RQ Nachdem man sich ein wenig damit beschäftigt hat, scheinen Pandoc-Vorlagen der falsche Weg für diese Funktionalität zu sein: Eine Vorlage erhält einen $body$ String und erwartet so ziemlich, nur Text davor und danach einzufügen, und scheint nicht zu sein beabsichtigt, den aus Markdown generierten Text tatsächlich zu manipulieren. Sie würden benutzerdefinierte Pandoc- article hinzufügt: siehe gist . Ich hoffe, dies erweitern zu können, während ich weiterhin tufte-css schreibe, um alle bereitgestellten Funktionen einzubeziehen – idealerweise ohne etwas am Pandoc-Markdown oder seinen Lesern ändern zu müssen.

(Der Vollständigkeit halber könnte ich

@fasiha gute

Ich glaube nicht, dass es in Markdown ein leicht verfügbares Äquivalent zu tufte-css _sections_ gibt, dh eine Gruppierung von Absätzen und Überschriften. Aber ich denke, ich mag die Idee der Abschnitte, ich denke, eine zusätzliche Ebene der Dokumentenorganisation wird in der Zukunft hilfreich sein.

Irgendwelche Vorschläge von der Community, wie man Abschnitte in Markdown kennzeichnen könnte?

@fasiha Wie wäre es mit einem Filter, der Überschriftenelemente und alle <section> (oder einige benutzerdefinierte <div> ) Tags ein und wenden Sie das gewünschte CSS darauf an?

Vielen Dank für das Wiegen von @vyp. Nach meiner Lektüre der tufte-css-Titelseite kann section mehr als eine Überschrift oder Absätze ohne Überschrift erfassen. Das heißt, es ist nicht nur ein Container für Überschriften und Inhalte. In meinem Dokument bette ich vorerst nur <section> als Roh-HTML in den Markdown ein – dafür kann ich Roh-HTML akzeptieren.

@fasiha Ah tut mir leid, du hast

Die Verwendung von rohen <section> Tags ist in diesem Fall das Beste, was Sie tun können (außer Ihre eigene markdown-ähnliche Syntax dafür zu definieren und einen Parser dafür zu schreiben).

Ein anderer Weg wäre, die Tatsache zu nutzen, dass Tufte sagt, dass es h2 für "Abschnittsüberschriften" verwendet, so dass möglicherweise ein "Abschnitt" als h2-Tag und alles bis zum nächsten h2-Tag usw. definiert werden kann. Aber ich bin mir nicht sicher, ob der Autor von Tufte dies beabsichtigt hat.

H2-Elemente sind keine zuverlässigen Quellen der Abschnittsabgrenzung. Einige Dokumente verwenden beispielsweise stattdessen "neu gedachte" Spannen. Ich bin sicher, dass andere Variationen in freier Wildbahn auftauchen werden.

Am 8. August 2015 um 23:49 schrieb vyp [email protected] :

@fasiha Ah tut mir leid, du hast

Rohmaterial verwenden

Tags ist in diesem Fall das Beste, was Sie tun können (außer Ihre eigene markdown-ähnliche Syntax dafür zu definieren und einen Parser dafür zu schreiben).

Ein anderer Weg wäre, die Tatsache zu nutzen, dass Tufte sagt, dass es h2 für "Abschnittsüberschriften" verwendet, so dass möglicherweise ein "Abschnitt" als h2-Tag und alles bis zum nächsten h2-Tag usw. definiert werden kann. Aber ich bin mir nicht sicher, ob der Autor von Tufte dies beabsichtigt hat.

—
Antworten Sie direkt auf diese E-Mail oder zeigen Sie sie auf GitHub an.

Ich denke, wenn jemand die Verwendung von <section> Tags in seinem Markdown vermeiden möchte, ist eine ähnliche Syntax wie die von <hr> möglicherweise nicht schwer zu implementieren. Die Syntax für <hr> ist im Grunde "drei oder mehr Bindestriche, Sternchen oder Unterstriche in einer Zeile für sich". So könnten Sie zum Beispiel willkürlich eine "Abschnittsabgrenzung" als "drei oder mehr Gleichheitszeichen" (oder was auch immer Sie bevorzugen) definieren und dann einen Pandoc-Filter verwenden, um alles zwischen diesen Absätzen nur mit Gleichheitszeichen einzuschließen.

Ich habe nur "eine Reihe von Gleichheitszeichen" gewählt, weil ich denke, dass das Teilen von Abschnitten mit Klartext _aussehen_ würde? Und da pandoc-Markdown dies nur als Absatz analysiert, was bedeutet, dass Ihr Filter einfach jeden Absatz überprüfen kann, ob er nur Gleichheitszeichen hat oder nicht, und wenn er nur aus Gleichheitszeichen besteht, nehmen Sie an, dass dies Teil einer Abschnittsabgrenzung ist.

Hallo zusammen (und danke an @daveliepmann für den Hinweis auf diesen Thread). Sie könnten an meinem glasseye- Paket interessiert

Wäre reStructuredText geeigneter als Markdown für die Art von Anmerkungen, die hier benötigt werden?

@coppeliaMLA Danke für die Erwähnung von glasseye, es ist unglaubliche Arbeit.

@rbcarson Ich bin kein OP, aber wenn sich die Frage hier an alle richtet und Sie meine Meinung haben möchten, bin ich persönlich mit restrukturiertem

Im Laufe der Jahre gibt es also nur eine begrenzte Anzahl anderer Syntaxtypen, die Sie in "Markdown" stopfen können, weil der springende Punkt darin besteht, dass sie in Klartextform lesbar sein soll. Wie vermittelt man Randnotizen visuell im Klartext? Trotzdem finde ich, dass der erweiterte Preisabschlag von pandoc in dieser Hinsicht wirklich gute Arbeit geleistet hat.

Ich denke also, restrukturierter Text hat so etwas wie Direktiven oder so etwas, mit dem Sie eine Syntax (oder etwas?) für einen bestimmten Datentyp erstellen können? Wenn das einigermaßen der Fall ist, ja, ich denke, restrukturierter Text ist hier wahrscheinlich besser zugänglich. Aber wie gesagt, ich habe nicht viel Erfahrung damit, daher kann ich dir nicht weiterhelfen.

restructuredText wäre für meine Zwecke unbrauchbar, das sind Projekte, die bereits im Markdown dokumentiert sind

Am 17. August 2015 um 4:24 Uhr schrieb vyp [email protected] :

@coppeliaMLA Danke für die Erwähnung von glasseye, es ist unglaubliche Arbeit.

@rbcarson Ich bin kein OP, aber wenn sich die Frage hier an alle richtet und Sie meine Meinung haben möchten, bin ich persönlich mit restrukturiertem

Im Laufe der Jahre gibt es also nur eine begrenzte Anzahl anderer Syntaxtypen, die Sie in "Markdown" stopfen können, weil der springende Punkt darin besteht, dass sie in Klartextform lesbar sein soll. Wie vermittelt man Randnotizen visuell im Klartext? Trotzdem finde ich, dass der erweiterte Preisabschlag von pandoc in dieser Hinsicht wirklich gute Arbeit geleistet hat.

Ich denke also, restrukturierter Text hat so etwas wie Direktiven oder so etwas, mit dem Sie eine Syntax (oder etwas?) für einen bestimmten Datentyp erstellen können? Wenn das einigermaßen der Fall ist, ja, ich denke, restrukturierter Text ist hier wahrscheinlich besser zugänglich. Aber wie gesagt, ich habe nicht viel Erfahrung damit, daher kann ich dir nicht weiterhelfen.

—
Antworten Sie direkt auf diese E-Mail oder zeigen Sie sie auf GitHub an.

@coppeliaMLA sehr interessant!: Verwenden Sie pandoc, um HTML mit speziellen Tags auszugeben, und verwenden Sie dann als zweiten Schritt ein anderes Programm, um die speziellen Tags auf Javascript und HTML zu erweitern. Mein Ansatz bestand darin, einen benutzerdefinierten Pandoc-Writer zu erstellen, der die speziellen Tags verwendet und effektiv glasseye.py in Lua durchführt, indem er Pandoc AST anstelle von BeautifulSoup-Parsing verwendet, aber es sieht so aus, als ob glasseye im Grunde gut funktioniert. Ich werde versuchen, meine Dokumente mit Glasseye zu überprüfen und Sie auf dem Repo über alle Probleme zu informieren. Dinge, die in einem Pandoc-Autor schwer zu tun sind, sind möglicherweise einfacher nachzubearbeiten und umgekehrt, aber der einzige Weg, dies herauszufinden, besteht darin, eine Reihe von Dokumenten zu schreiben :)

@fasiha danke. Ihr Weg klingt effizienter und ich denke, dass ich vielleicht am Ende in diese Richtung gehen könnte. Ich habe mich für Python entschieden, da ich damit einen schnellen Prototyp erstellen konnte. Aber wie Sie sagen, wird das Experimentieren mit vielen Dokumenten die beste Methode verfeinern. Ich plane, es für so viel wie möglich von meiner täglichen Arbeit zu verwenden, um zu sehen, wohin es mich führt. Wäre toll, wenn du es ausprobieren könntest. Liebe zu hören, wie es geht!

Siehe #31 und auch #58

Was es wert ist: Ich habe gerade tufte-pandoc-css , um das Problem des Schreibens von Randnotizen in Markdown zu lösen. Es ist nur ein Beispiel für die Verwendung eines benutzerdefinierten Pandoc-Filters, den ich mit dem Namen pandoc-sidenote .

Um es in Aktion zu sehen:

• Eine Neuimplementierung tufte-css/index.html in Markdown mit Pandoc-Geschmack
• Eine Demo einiger anderer Pandoc-Funktionen , wie z. B. Codeblöcke mit Syntaxhervorhebung.

@jez Cool! Ich werde sehen, ob ich ein Projekt finde, mit dem ich einen Wirbel machen kann.

Habe gerade diesen Thread über Google gefunden

Vielleicht möchten Sie einen Blick auf xmark werfen : das wandelt Markdown in Tufte-CSS über XSLT um.

@vieiro wow das ist schön. Tolle Arbeit 👍🏻