diff --git a/README.md b/README.md index c4df3ec..c244e1b 100644 --- a/README.md +++ b/README.md @@ -50,6 +50,8 @@ create a LaTeX file, or the TEI file can be converted into the customized DocBook format from above workflow so that the existing tools can be used. +See `doc/XSL.md` for a documentation of the XSL workflow. + ## Examplary workflow To install the whole toolchain, clone at least this repository as well diff --git a/data/tei2eoatex-common.xsl b/data/tei2eoatex-common.xsl new file mode 100644 index 0000000..fa70f2b --- /dev/null +++ b/data/tei2eoatex-common.xsl @@ -0,0 +1,464 @@ + + + + + + ⸎ List of contributors + + + + + + \noindent\textbf{ + + + + + } + + \noindent + + \\ + + \noindent + + \\ + + + \noindent + + \\ + + + + + + + + + + + + + + + + + ⸎ New version: 160205 reflecting hierarchy of EOA over MPRL + ⸎ Last used for Studies 8: Space volume + \pagestyle{empty} \pagenumbering{roman} \setcounter{page}{1} ⸎ + ⸎ Page 1: Just the title \begin{center} \Large{ + + }\\ \vspace{2mm} \large{ + + } \end{center} \newpage + ⸎ Page 2: Series Editors, Team, Board, Edition Open Access description, year + \begin{center} \large \EOAbold{ + + } \end{center} + \vspace{15mm} \noindent\EOAbold{ + + }\\[2mm] + + + \vspace{10mm} \noindent\EOAbold{Edition Open Access Development Team}\\[2mm] + + \vspace{10mm} \noindent + + \vspace{3pt} \noindent + + \newpage + ⸎ Page 3: Title, subtitle, author/editor, series, year \begin{minipage}[t]{90mm} + \vspace*{12mm} \begin{center} \Large { + + }\\ \vspace{2mm} \large{ + + } \end{center} \vspace{10mm} \begin{center} \large + + + + + + + + + + + + + (ed.) + + + (Hrsg.) + + + + + + + (eds.) + + + (Hrsg.) + + + + + + \end{center} \vspace{126mm} \begin{center} \large {\EOAbold{ + + }} \end{center} \end{minipage}\newpage + ⸎ Page 4: Complete Series Information, Communicator, Assistance, Gratitude, + ⸎ ISBN-Number, License \begin{flushleft} \noindent + + \\ \noindent + + \\ \vspace{4mm} \noindent Submitted by: + + + + + \\ \vspace{4mm} \noindent Editorial Team:\\ + + + + + \\ \vspace{4mm} \noindent Image Processing: \\ + Digitization group of the Max Planck Institute for the History of Science\\ + ⸎ \noindent Sponsoring Institutions: optional info + + \noindent Scholarly Support: + + + + + \noindent Financial Support: + + + + \vspace{4mm} \noindent Cover Image:\\ \noindent + + + \\ \vspace{4mm} \noindent + + \end{flushleft} + \vfill \begin{flushleft} \begin{footnotesize} \noindent ISBN + + \\ First published + + by + + ,\\ Max Planck Institute for the History of Science\\ + + \\ Printed and distributed by\\ + + \\ Published under + + \\ + + \\[2mm] The Deutsche Nationalbibliothek lists this publication in the Deutsche Nationalbibliografie; detailed bibliographic data are available in the Internet at http://dnb.d-nb.de. + \end{footnotesize} \end{flushleft} \newpage \normalsize + ⸎ Page 5: Complete Series Information, \noindent \small\EOAbold{ + + }\\ \vspace{6pt} \noindent + + \vspace{30pt} \noindent\small\EOAbold{Scientific Board}\\ \vspace{3pt} + \begin{footnotesize} \noindent + + \end{footnotesize} \clearpage \mbox{} ⸎ \newpage + ⸎ Optional: Pages 5 and 6: Dedication, followed by a blank page + + \vspace*{25mm} \begin{center} + + \end{center} \clearpage \mbox{} + + ⸎ \newpage \normalsize + ⸎ Following pages use normal page style, which is fancy + \pagestyle{fancy} + + + + + + + + + + + + + \begin{EOAquote} + + \end{EOAquote} + + + + + + + + + + \EOAemph{ + + } + + + + + + \EOAsection + + + \EOAsubsection + + + \EOAsubsubsection + + + + + nonumber + + + INFO: Section has number + + + { + + } + + + INFO: No ID for section + + + \EOAlabel{ + + } + + + + + + + + + \EOAciteyear + + + \EOAciteauthoryear + + + + + [ + + ] + + + + + [ + + + + + + + + INFO: citation has no to value + + + ] + + + + + { + + } + + + + \EOAfn{ + + + + + + INFO: Number of paragraphs in larger than 1 + + + + + \EOAfnpar + + + + + + + + + } + + + + \EOAref{ + + } + + + + \EOAurl{ + + } + + + + \refstepcounter{figure}⸎ + + + + \EOAfigure{ + + }{ + + } + { + + } + + {66} + + {ht} + + + + + + + + \EOAprintbibliography[ + + ] + + + \EOAprintbibliography + + + + + \EOAprintindex + + + \EOAprintpersonindex + + + \EOAprintlocationindex + + + WARNING: Unrecognized processing instruction + + + + + + + + + + + + + + + + + + + + + and + + + + + + + + + + , + + + and + + + + + + No book author. + + + + + + + + + + diff --git a/data/tei2eoatex-noparts.xsl b/data/tei2eoatex-noparts.xsl new file mode 100644 index 0000000..c7a88cb --- /dev/null +++ b/data/tei2eoatex-noparts.xsl @@ -0,0 +1,166 @@ + + + + + + + + + + + + + + + + + + + + + + WARNING: Unmatched element: + + + + + + + ⸎ LaTeX output, generated by a script on + + + \input{preambel/pre_eoa} + \EOAbibliographytype{ + + } + \EOAbibliographydatabase{ + + } + \EOAseries{ + + } + \begin{document} \input{texfiles/frontmatter.tex} + \EOAtoc \newpage \pagenumbering{arabic} \setcounter{page}{1} + + + + \EOAchapternonumber{List of Contributors}{List of Contributors} + \input{texfiles/contributors.tex} + + + + INFO: Not writing list of contributors + + + + + + \EOAchapter + + + nonumber + + + INFO: Section has number + + + + + { + + }{ + + + + { + + }{ + + + + + + + + + \EOAauthor{ + + + + + + + \EOAauthor{ + + + + + and + + + + + \EOAauthor{ + + + + + + , + + + and + + + + + + INFO: No chapter author. + } + + + } + } + + + INFO: Chapter has no ID + + + \EOAlabel{ + + } + + + \input{ + + } + + + + ⸎ single file + + + + \end{document} + + + + diff --git a/data/tei2eoatex-parts.xsl b/data/tei2eoatex-parts.xsl new file mode 100644 index 0000000..b86b8cf --- /dev/null +++ b/data/tei2eoatex-parts.xsl @@ -0,0 +1,184 @@ + + + + + + + + + + + + + + + + + + + + + + WARNING: Unmatched element: + + + + + + + ⸎ LaTeX output, generated by a script on + + + \input{preambel/pre_eoa} + \EOAbibliographytype{ + + } + \EOAbibliographydatabase{ + + } + \EOAseries{ + + } + \begin{document} \input{texfiles/frontmatter.tex} + \EOAtoc \newpage \pagenumbering{arabic} \setcounter{page}{1} + + + + \EOAchapternonumber{List of Contributors}{List of Contributors} + \input{texfiles/contributors.tex} + + + + INFO: Not writing list of contributors + + + + + + + \EOApart{ + + + + INFO: No ID for part + } + + + }\EOAlabel{ + + } + + + + + \EOAchapter + + + nonumber + + + INFO: Section has number + + + + + { + + }{ + + + + { + + }{ + + + + + + + + + \EOAauthor{ + + + + + + + \EOAauthor{ + + + + + and + + + + + \EOAauthor{ + + + + + + , + + + and + + + + + + INFO: No chapter author. + } + + + } + } + + + INFO: Chapter has not ID + + + \EOAlabel{ + + } + + + \input{ + + } + + + + + ⸎ single file + + + + + \end{document} + + + + diff --git a/data/tei2eoatex.xsl b/data/tei2eoatex.xsl deleted file mode 100644 index 7993e92..0000000 --- a/data/tei2eoatex.xsl +++ /dev/null @@ -1,369 +0,0 @@ - - - - - - - - - - WARNING: Unmatched element: - - - - - \EOAbibliographytype{ - - } - \EOAbibliographydatabase{ - - } - - - - \input{preambel/pre_eoa} - \EOAseries{ - - } - - - - - - - - - - - - - \begin{EOAquote} - - \end{EOAquote} - - - - - - - - - - \begin{document} \EOAtoc \newpage %beginning of chapter - - % end of chapter \end{document} - - - - - \EOAemph{ - - } - - - - \EOAchapter - - - nonumber - - - INFO: Section has number - - - { - - } - { - - - - - - - \EOAauthor{ - - - - - - - \EOAauthor{ - - - - - and - - - - - \EOAauthor{ - - - - - - , - - - and - - - - - - INFO: No chapter author. - } - - - } - - - - INFO: Chapter has not ID - - - \EOAlabel{ - - } - - - - - - - - \EOApart - - - \EOAsection - - - \EOAsubsection - - - \EOAsubsubsection - - - - - nonumber - - - INFO: Section has number - - - { - - } - - - INFO: No ID for section - - - \EOAlabel{ - - } - - - - - - - - - \EOAciteyear - - - \EOAciteauthoryear - - - - - [ - - ] - - - - - [ - - - - - - - - INFO: citation has no to value - - - ] - - - - - { - - } - - - - - - \EOAfn{ - - - - - - INFO: Number of paragraphs in larger than 1 - - - - - \EOAfnpar - - - - - - - - - } - - - - - - \EOAref{ - - } - - - - \EOAurl{ - - } - - - - \refstepcounter{figure}% - - - - \EOAfigure{ - - }{ - - } - { - - } - - {66} - - {ht} - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - \EOAprintbibliography - - diff --git a/doc/XSL.md b/doc/XSL.md new file mode 100644 index 0000000..3a8c016 --- /dev/null +++ b/doc/XSL.md @@ -0,0 +1,34 @@ +# The XSL workflow + +A 2.0 XSL processor is required to perform the transformation of the +TEI manuscript to LaTeX files. It has been successfully used with +Saxon-HE 9.7.0.21J, found at +[sourceforge](https://sourceforge.net/projects/saxon/files/Saxon-HE/9.7/SaxonHE9-7-0-21J.zip/download). + +There are two files to choose from, depending on whether the highest +element of a publication is part (`tei2eoatex-parts.xsl`) or chapter +(`tei2eoatex-noparts.xsl`). Both scripts then import +`tei2eoatex-common.xsl` which contains the rest of the templates. + +There is command line parameter available which toggles the creation +and inclusion of a List of Contributors (mainly used in edited books). +It is set to `false` by default. Enable it by adding + + contributors=1 + +to the command line. + +## Output + +The transformation will create a number of files that closely +resembles the structure in the classic EOATeX way. There is one main +file that links to the separate chapter files which are located in a +directory `texfiles`. + +## Working with the LaTeX files + +The LaTeX files are considered temporary files to create a PDF version +of the TEI text. All changes to the contents and structure of the text +should be made in the master TEI file. However, some elements need to +be fixed at the LaTeX level, e.g. the placement and size of images, +line and page breaks or hyphenation.