Asciidoc Rollen und Gitarbook

Question

Ich versuche, Gitbook mit AsciiDoc zu verwenden (mit Win10x64, NodeJS 6.9.1 und Gitbook v3.2.2) - ich bin neu bei beiden.

The Gitbook documentation says AsciiDoc ist seit v2.0.0 und Link zu den AsciiDoctor documentation unterstützt - ich die Knoten Pakete überprüft haben, hängt gitbook auf gitbook-asciidoc die wiederum auf asciidoctor.js abhängt.

Gemäß der Dokumentation können AsciiDoc-Rollen zum Formatieren von Bildern und Tabellen verwendet werden. Sie beziehen sich auf Klassen, die auf das HTML-Element angewendet werden, wobei diese Klassen im Standard-AsciiDoctor-Format definiert sind.

Aber egal wie ich versuche, eine Rolle, zum Beispiel auf ein Bild ([.text-center] shorthand oder [role="text-center"]), ich bekomme nicht die erwartete Ausgabe (dh das Bild horizontal zentriert). Der einzige Weg, wie ich es schaffen kann Arbeit für das Bild ist durch das Setzen eines Attributs align = "center", das ist auch nicht dokumentiert.

Durch die Überprüfung der Ausgabe in meinem Browser kann ich sehen, dass Klassen auf die HTML-Elemente angewendet werden, aber es gibt keine passenden CSS-Regeln - Das gleiche gilt für das Tabellen-Styling, soweit ich es versucht habe.

Was fehlt mir hier an den AsciiDoctor Rollen und Stylesheets?

EDIT: asciidoctor.js ist eine devDependency von gitbook und ist eigentlich nicht mit gitbook installiert. Die align="center" ist in der AsciiDoc documentation dokumentiert, aber andere Funktionen wie Tisch-Styling (mindestens die frame="none" und grid="none") scheinen nicht mit gitbook zu arbeiten.

ich immer noch nicht, warum Gitbook Dokumentation Links zurück zur AsciiDoctor ist ein, wenn es nicht unterstützt wird ...

Answer 1

Wenn Sie AsciiDoc Syntax in GitBook verwenden, AsciiDoctor verwendet wird, um die AsciiDoc Syntax in HTML zu transformieren. Der HTML-Code verwendet dann GitBook-CSS, da Sie ein GitBook-Theme und nicht ein AsciiDoctor-Theme verwenden. Das bedeutet, dass Sie nicht das Standard-AsciiDoctor-Styling erhalten.

Es ist einfach, eigene Stile in GitBook hinzuzufügen. In Ihrem book.json, geben Sie ein zusätzliches Sheet:

"styles": { 
    "website": "styles/mystyles.css" 
}, 

Dann erstellen styles/mystyles.css, so dass es die CSS-Stile enthält, die Sie verwenden möchten:

.text-center { 
    text-align: center; 
} 

Sie können Stile aus dem AsciiDoctor Sheet in styles/mystyles.css kopieren , aber seien Sie bereit, die Stile und Klassen so zu optimieren, dass sie innerhalb des von Ihnen verwendeten GitBook-Themas funktionieren.