Differences

This shows you the differences between two versions of the page.

--- shortintroduction [2018/05/28 15:56]
kthoden [Prerequisites & Typesetting]
+++ shortintroduction [2020/01/30 11:29] (current)
kthoden [Prerequisites & Typesetting]
@@ Line 3: / Line 3: @@
 The core of our publishing strategy is a canonical format which is currently based on using LaTeX with a restricted number of commands that cover all the necessary features of scientific texts. To fulfill these requirements, it is imperative that certain basic rules are followed so that the authors' texts can easily be converted into the various publishing formats: HTML for viewing the text online, epub for ebook readers, and PDF for printing.
-Before continuing we recommend that you download the software, install the recommended packages and work through the sample project. See the links on the right for quick navigation.
+Before continuing we recommend that you download the software, install the recommended packages and work through the sample project. See the links in the sidebar for quick navigation.
 ==== Getting started ====
-We are currently supporting the distribution of 2013 which you can download and install from [[ftp://tug.org/historic/systems/texlive/2013/|the archive]]. Furthermore, an editor for editing LaTeX code is required. We recommend using [[http://edition-open-access.de/support/texshop.html|TeXShop]] on Apple computers and [[http://edition-open-access.de/support/texworks.html|TeXWorks]] for Windows.
+We are currently supporting the distribution of 2019 which you can download and install from [[ftp://tug.org/historic/systems/texlive/2019/|the archive]]. Furthermore, an editor for editing LaTeX code is required. We recommend using [[texshopconfiguration|TeXShop]] on Apple computers and [[texworksconfiguration|TeXWorks]] for Windows.
-Please note that self-defined LaTeX-Macros are not supported. The special LaTeX commands defined for this system ensure maximum consistency and convertibility. Without this restriction, it would be impossible to convert the publications into ePub and HTML. The list of authorized commands is available in a [[http://edition-open-access.de/media/support/files/EOAReference.pdf|separate document]].
+Please note that self-defined LaTeX-Macros are not supported. The special LaTeX commands defined for this system ensure maximum consistency and convertibility. Without this restriction, it would be impossible to convert the publications into ePub and HTML. The list of authorized commands is available [[eoacommands|on this page]], as well as in a [[http://edition-open-access.de/media/support/files/EOAReference.pdf|separate document]].
 For a quick start and to check if the LaTeX installation works, download the preamble ''pre_eoa.tex'', start the LaTeX editor and paste the following code into the window:
-> \include{pre_eoa}
+<code eoatex>
-> \begin{document}
+\include{pre_eoa}
-> Ciao EOA
+\begin{document}
-> \end{document}
+Ciao EOA
+\end{document}
+</code>
 Save that file in the same place where you put the preamble, select XeLaTeX from the second menu to the left and click on "Setzen". If everything went well, you should see two new windows: the log window and the resulting PDF. You can now start and set up a real project.
-{{ :ciao_eoa.png?nolink&600 |}}
+{{ support:ciao_eoa.png?600 |}}
 ==== Setting up a project ====
-Create a folder on your computer which will contain the data for the whole project. Download the preamble from this site (link top right). The preamble contains all the commands and layout definitions. All TeX files (including BibTeX files) should be placed in this single folder. Illustrations and graphics are best stored jointly in a subfolder called 'Images.'
+Create a folder on your computer which will contain the data for the whole project. Download the preamble from this site (link top left). The preamble contains all the commands and layout definitions. All TeX files (including BibTeX files) should be placed in this single folder. Illustrations and graphics are best stored jointly in a subfolder called 'Images.'
 File and directory names must begin with a letter and not include blanks, umlauts or other special characters (except hyphens and underscores).
@@ Line 34: / Line 36: @@
 If illustrations and graphics are placed in a subfolder, the path has to be made explicit in the TeX file:
-> \EOAfigure{Images/Figure_1.png}{Caption}{Label}{99}{ht}
+<code eoatex>
+\EOAfigure{Images/Figure_1.png}{Caption}{Label}{99}{ht}
+</code>
 Each project consists of at least three files:
@@ Line 44: / Line 48: @@
 Each main file begins with the commands
-> \include{pre_eoa}
+<code eoatex>
-> \EOAbibliographytype{monograph}
+\include{pre_eoa}
-> \EOAbibliographydatabase{biblio}
+\EOAbibliographytype{monograph}
-> \EOAseries{Proceedings}
+\EOAbibliographydatabase{biblio}
-> \begin{document}
+\EOAseries{Proceedings}
+\begin{document}
+</code>
 The purpose of the first line is to embed the macros and commands that are defined in the preamble. The command ''\EOAbibliographytype'' in the second line defines what kind of bibliography is being created. Use ''{monograph}'' for one large bibliography at the end of the publication or ''{anthology}'' for one bibliography at the end of each chapter. The command ''\EOAseries'' may contain one keyword (Studies, Sources, Proceedings or Textbooks). It defines the dimensions of the book and may alter various options. The command ''\EOAbibliographydatabase'' refers to the file containing the bibliographic database. In the example above, the command refers to the file ''biblio.bib''.
@@ Line 54: / Line 60: @@
 The main text ends with the command
-> \end{document}
+<code eoatex>
+\end{document}
+</code>
 The title and author of the publication as well as other links like ISBN and frontmatter will be provided by the Edition Open Access Team before publishing.
@@ Line 62: / Line 70: @@
 In general, the implemented procedure is independent of any computer platform, editor and program. The only prerequisite is that the authors have a basic LaTeX environment installed, which is available for all commonly used operating systems. We use [[https://en.wikipedia.org/wiki/XeLaTeX|XeLaTeX]] (which is part of the standard distribution of TeX) instead of ''pdflatex'' or ''latex''. This enables us to type Unicode (UTF-8) and avoid the coding of non-ASCII-characters. This applies in particular to non-Latin scripts such as Classical Greek or Chinese. Furthermore, we use BibLaTeX, a complete reimplementation of [[https://en.wikipedia.org/wiki/BibTeX|BibTeX]] alongside with [[https://en.wikipedia.org/wiki/Biber_%28LaTeX%29|Biber]]. This enables us to accurately typeset bibliographies that include non-Latin scripts. All these programs are already included in the current releases and do not have to be downloaded separately.
-Please note: This procedure requires the configuration of most editors (such as [[http://edition-open-access.de/support/texshop.html|TeXShop]], [[http://edition-open-access.de/support/texworks.html|TeXWorks]], [[http://edition-open-access.de/support/bibdesk.html|BibDesk]] and [[http://edition-open-access.de/support/jabref.html|JabRef]]). In general, you must use the command ''xelatex'' rather than ''pdflatex'' or ''latex''. In addition, the command ''biber'' has to be used instead of ''bibtex''. Typesetting the publication therefore requires the following commands:
+Please note: This procedure requires the configuration of most editors (such as [[texshopconfiguration|TeXShop]], [[texworksconfiguration|TeXWorks]], [[bibdeskconfiguration|BibDesk]] and [[jabrefconfiguration|JabRef]]). In general, you must use the command ''xelatex'' rather than ''pdflatex'' or ''latex''. In addition, the command ''biber'' has to be used instead of ''bibtex''. Typesetting the publication therefore requires the following commands:
-  - xelatex Main_TeX_File
+  - ''xelatex Main_TeX_File''
-  - biber Main_TeX_File
+  - ''biber Main_TeX_File''
-  - xelatex Main_TeX_File
+  - ''xelatex Main_TeX_File''
 The command ''makeindex'' is not used. The index is generated using the package *imakeidx* which is included in the preamble.
-The current distribution of TeX (2013) is used for the time being. For Mac and Windows users, this is combined with a convenient working environment that runs on Mac systems OS X 10.6 or higher, or Windows Vista and later.
+The current distribution of TeX (2019) is used for the time being. For Mac and Windows users, this is combined with a convenient working environment that runs on Mac systems OS 10.12 (Sierra) or higher, or Windows Vista and later.

Edition Open Access

User Tools

Site Tools

Differences

Page Tools