Informationspraxis / artikel-vorlage

Vorlage zur Konvertierung von Informationspraxisartikeln von DOCX via MD nach HTML, EPUB und PDF
5 stars 4 forks source link

Automatische Nummerierungen in der Word-Vorlage (Überschriften, Tabellen, Abbildungen) #11

Open zuphilip opened 4 years ago

zuphilip commented 4 years ago

Word kann ebenfalls Überschriften, Abbildungen und Tabellen automatische nummerieren und ich würde vorschlagen, dies in die Vorlage entsprechend einzubauen.

  1. Für Überschriften kann man dies einfach einmal einstellen und dann die ganzen händischen Nummern löschen: https://praxistipps.chip.de/ms-office-word-ueberschriften-automatisch-nummerieren_33622
  2. Bei Abbildungen kann man relativ leicht mit Bildunterschriften arbeiten (rechtsklick auf Bild und dann Bildunterschrift einfügen klicken). Hier muss auch der Doppelpunkt als Trennzeichen eingegeben werden sowie ein Abstand zum eigentlichen Text.
  3. Bei Tabellen kann man ebenfalls Tabellenunterschriften einfügen, aber die Handhabung ist etwas gewöhnungsbedürftig: https://praxistipps.chip.de/word-tabellen-beschriften-so-gehts_49247 . Dies könnte man evt. im Begleittext etwas ausformulieren.

Ist es okay, die Vorlage entsprechend zu ändern?

Zusätzlich habe ich aber noch zwei Fragen:

felixlohmeier commented 4 years ago

Ist es okay, die Vorlage entsprechend zu ändern?

Aus meiner Sicht ja, wobei in der Praxis die Vorlagen wohl oft nicht verwendet oder unwissentlich umformatiert werden.

Zusätzlich habe ich aber noch zwei Fragen:

Zu den inhaltlichen Fragen müsste jemand was sagen, der mehr in der Redaktionspraxis drin ist. @hauschke?

zuphilip commented 4 years ago

Okay, dann mache ich mal die entsprechenden Anpassungen in den Vorlagen.

Bei den aktuellen Artikel sehe ich "Abb." und "Tab.", aber im LaTeX-Template steht explizit

\usepackage[small,figurename=Abbildung,tablename=Tabelle]{caption}

das kann man natürlich leicht ändern.

Bisher habe ich die Bildunterschriften in Markdown auch immer manuell verschoben, d.h. aus

![](image1.png)

Abb. 1: Titel Abbildung 1

habe ich dann

![Titel Abbildung 1](image1.png)

gemacht, aber jetzt habe ich gerade gesehen, dass dies in der MD-Vorlage so nicht vorgesehen ist. Kann ich das in der MD-Template auch korrigieren? Oder ist dies bewusst so gemacht? Bin mir nicht sicher, ob es etwas entsprechendes für Tabellen in MD gibt...

felixlohmeier commented 4 years ago

Ich vermute ![Titel Abbildung 1](image1.png) führt nicht zu einem lesbaren Text im generierten HTML/PDF/ePUB. Aber Du kannst von mir aus gerne alles anfassen und optimieren. Falls der Redaktion etwas nicht passen sollte (und wir sollten dann wirklich mal eine Videokonferenz dazu machen), können wir die alte Version durch git ja schnell wiederherstellen. Also lass Dich nicht aufhalten :-)

zuphilip commented 4 years ago

Die Caption in Markdown wird schon weiter betrachtet, etwa nach LaTeX umgewandelt:

\begin{figure}
\centering
\includegraphics{image1.png}
\caption{Titel Abbildung 1}
\end{figure}

bzw. nach HTML

<figure>
<img src="image1.png" alt="Titel Abbildung 1" /><figcaption>Titel Abbildung 1</figcaption>
</figure>

Ich versuche da einmal weiter voranzukommen. Ggf. kann man ja immer noch mal einen weiteren Branch aufmachen...

zuphilip commented 4 years ago

Die Bildunterschrift ist auch im EPUB, aber die automatische Nummerierung inklusive dem Voranstellen des "Abb." bzw. momentan noch "Abbildung" funktioniert nur im PDF. Bin mir nicht sicher ob man bei der HTML- und EPUB-Erzeugung dies entsprechend ändern kann oder eher versuchen sollte das automatische Nummerieren im PDF abzustellen...

zuphilip commented 4 years ago

Prinzipiell funktionieren beide Wege, aber sind unterschiedlich komplex.

Es gibt beispielsweise das Pandoc-Plugin https://github.com/tomduck/pandoc-fignos welches solche Nummerierung dann in allen Formaten erstellt. Dies funktioniert aber natürlich nur, wenn die Angaben im Markdown, welches normalerweise von einer Transformation von DOCX oder ODT stammen, korrekt und wie von uns gewünscht gemacht wird. Zudem bin ich mir nicht sicher, ob man dann die Referenzen in Word so machen kann, dass das gewünschte in MD herauskommt. Die Komplexität des Erstellens der Fahnen würde sich auch erhöhen und eine zusätzliche Abhängigkeit haben.

Die zweite Variante wäre einfach das automatische Nummerieren in LaTeX abzustellen. Dazu genügt es am Anfang im Template bei dem Packet labelformat=empty anzugeben. Das scheint mir weniger komplex und fehleranfällig. Daher mache ich dazu meinen nächsten PR.

Übrigens funktionieren Tabellenbeschriftungen ebenfalls mit einem vorangestellten Table: oder auch einfach :. Zudem habe ich beides erfolgreich auch mit EPUB getestet.