diff options
author | Karl Berry <karl@freefriends.org> | 2020-07-08 21:18:08 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-07-08 21:18:08 +0000 |
commit | 637224a93d20e487f3ba4cdc5040a68c86fb6617 (patch) | |
tree | 73e4ed9dd1fcd4a3762e2367457f3a69cd70ecaf /Master/texmf-dist/doc/lualatex | |
parent | c226379cc4863e82904bd636c705d73c20670015 (diff) |
ekdosis (8jul20)
git-svn-id: svn://tug.org/texlive/trunk@55786 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/lualatex')
-rw-r--r-- | Master/texmf-dist/doc/lualatex/ekdosis/README.md | 130 | ||||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.el | 150 | ||||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.pdf | bin | 0 -> 362094 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1-tei.xml | 225 | ||||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.pdf | bin | 0 -> 17989 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.tex | 118 |
6 files changed, 623 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/lualatex/ekdosis/README.md b/Master/texmf-dist/doc/lualatex/ekdosis/README.md new file mode 100644 index 00000000000..4baa1e9727e --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/ekdosis/README.md @@ -0,0 +1,130 @@ +--- +author: +- Robert Alessi +title: 'The ekdosis package – README file' +--- + +Overview +======== +`ekdosis` is a LuaLaTeX package designed for multilingual critical +editions. It can be used to typeset texts and different layers of +critical notes in any direction accepted by LuaTeX. Texts can be +arranged in running paragraphs or on facing pages, in any number of +columns which in turn can be synchronized or not. In addition to +printed texts, `ekdosis` can convert `.tex` source files so as to +produce `TEI xml` compliant critical editions. Database-driven +encoding under LaTeX then allows extraction of texts entered segment +by segment according to various criteria: main edited text, variant +readings, translations or annotated borrowings between texts. It is +published under the terms of the GNU General Public License (GPL) +version 3. + +Notice to the Gentle Reader +=========================== +The current state of this documentation covers the basics of +`ekdosis`, namely what should be enough to start a new document and +see how it works. v1.0 with a full documentation should be out by the +end of July. Until then, there is a web page that can be accessed, +<http://www.robertalessi.net/ekdosis>, with a mailing list that one can +subscribe to and a section entitled “Literature” where one will find +some slides and a paper submitted to a journal. + +License and Disclamer +===================== +ekdosis – Typesetting TEI xml Compliant Critical Editions + +Copyright ⓒ 2020 Robert Alessi + +Please send error reports and suggestions for improvements to Robert +Alessi: + +- email: <alessi@robertalessi.net> + +- website: <http://www.robertalessi.net/ekdosis> + +- comments, feature requests, bug reports: + <https://gitlab.com/ralessi/ekdosis/issues> + +This program is free software: you can redistribute it and/or modify it +under the terms of the GNU General Public License as published by the +Free Software Foundation, either version 3 of the License, or (at your +option) any later version. + +This program is distributed in the hope that it will be useful, but +WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General +Public License for more details. + +You should have received a copy of the GNU General Public License along +with this program. If not, see <http://www.gnu.org/licenses/>. + +This release of icite consists of the following source files: + +- `ekdosis.dtx` + +- `ekdosis.ins` + +- `ekdosis.el` + +- `Makefile` + +License Applicable to the Documentation +--------------------------------------- +Copyright ⓒ 2020 Robert Alessi + +The documentation file `ekdosis.pdf` that is generated from the +`ekdosis.dtx` source file is licensed under the GNU Free Documentation +License, as follows:--- + +Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.3 + or any later version published by the Free Software Foundation; with + no Invariant Sections, no Front-Cover Texts, and no Back-Cover + Texts. A copy of the license is included in the section entitled + “GNU Free Documentation License”. + +Installation +============ +1. Run `'latex ekdosis.ins'` to produce the `ekdosis.sty` and + `ekdosis.lua` files. + +2. To finish the installation you have to move the `ekdosis.sty` and + `ekdosis.lua` files into a directory where LaTeX can find it. See + the FAQ on `texfaq.org` at <https://texfaq.org/FAQ-inst-wlcf> for + more on this. + +Development, Git Repository +=========================== + +Browse the Code +--------------- +You can browse icite repository on the web: +<http://git.robertalessi.net/ekdosis> + +From this page, you can download all the releases of `ekdosis`. For +instructions on how to install `ekdosis`, please see above. + +Comments, Feature Requests, Bug Reports +--------------------------------------- +<https://gitlab.com/ralessi/ekdosis/issues> + + +Download the Repository +----------------------- +`ekdosis` development is facilitated by git, a distributed version +control system. You will need to install git (most GNU/Linux +distributions package it in their repositories). + +Use this command to download the repository + + git clone http://git.robertalessi.net/ekdosis + +A new directory named icite will have been created, containing +`ekdosis`. + +Git Hosting +----------- +Make an account on <https://gitlab.com> and navigate (while logged in) +to <https://gitlab.com/ralessi/ekdosis>. Click *Fork* and you will +have in your account your own repository of `ekdosis` where you will +be able to make whatever changes you like to. diff --git a/Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.el b/Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.el new file mode 100644 index 00000000000..3d1547b4c80 --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.el @@ -0,0 +1,150 @@ +;;; ekdosis.el --- AUCTeX style for `ekdosis.sty' +;; This file is part of the `ekdosis' package + +;; ekdosis -- TEI xml compliant critical editions +;; Copyright (C) 2020 Robert Alessi + +;; Please send error reports and suggestions for improvements to Robert +;; Alessi <alessi@robertalessi.net> + +;; This program is free software: you can redistribute it and/or modify +;; it under the terms of the GNU General Public License as published by +;; the Free Software Foundation, either version 3 of the License, or +;; (at your option) any later version. + +;; This program is distributed in the hope that it will be useful, but +;; WITHOUT ANY WARRANTY; without even the implied warranty of +;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU +;; General Public License for more details. + +;; You should have received a copy of the GNU General Public License +;; along with this program. If not, see +;; <http://www.gnu.org/licenses/>. + +(defvar LaTeX-ekdosis-preamble-options + '(("parnotes" ("true" "false" "roman")) + ("teiexport" ("true" "false" "tidy")) + ("layout" ("float" "footins"))) + "Package options for the ekdosis package.") + +(defun LaTeX-ekdosis-package-options () + "Prompt for package options for ekdosis package." + (TeX-read-key-val t LaTeX-ekdosis-preamble-options)) + +(defun LaTeX-ekdosis-long-key-val (optional arg) + (let ((crm-local-completion-map + (remove (assoc 32 crm-local-completion-map) + crm-local-completion-map)) + (minibuffer-local-completion-map + (remove (assoc 32 minibuffer-local-completion-map) + minibuffer-local-completion-map))) + (TeX-argument-insert + (TeX-read-key-val optional arg) + optional))) + +(defvar LaTeX-ekdosis-declarewitness-options + '(("settlement") + ("repository") + ("msName") + ("origDate") + ("idno")) + "List of local options for DeclareWitness macro.") + +(defvar LaTeX-ekdosis-app-options + '(("type")) + "Local option for app|note macro.") + +(defvar LaTeX-ekdosis-lem-options + '(("wit") + ("alt") + ("pre") + ("post") + ("prewit") + ("postwit") + ("sep") + ("nolem" ("true" "false")) + ("nosep" ("true" "false"))) + "Local options for lem macro") + +(defvar LaTeX-ekdosis-rdg-options + '(("wit") + ("alt") + ("pre") + ("post") + ("prewit") + ("postwit") + ("nordg" ("true" "false"))) + "Local options for rdg macro.") + +(defvar LaTeX-ekdosis-note-options + '(("type") + ("lem") + ("labelb") + ("labele") + ("sep") + ("pre") + ("post")) + "Local options for note macro.") + +(defvar LaTeX-ekdosis-note-star-options + '(("pre") + ("post")) + "Local options for note* macro.") + +(defvar LaTeX-ekdosis-alignment-key-val-options + '(("tcols") + ("lcols") + ("texts") + ("apparatus") + ("flush" ("true" "false")) + ("paired" ("true" "false")) + ("pagelineation" ("true" "false"))) + "Local options for alignment env.") + +(TeX-add-style-hook + "ekdosis" + (lambda () + ;; Folding features: + (add-to-list (make-local-variable 'LaTeX-fold-macro-spec-list) + '("{1}" ("app")) + t) + (add-to-list (make-local-variable 'LaTeX-fold-macro-spec-list) + '("{7}||{6}||{5}||{4}||{3}||{2}||{1}" ("lem")) + t) + (add-to-list (make-local-variable 'LaTeX-fold-macro-spec-list) + '("[r]" ("rdg")) + t) + (add-to-list (make-local-variable 'LaTeX-fold-macro-spec-list) + '("[n]" ("note")) + t) + (add-to-list (make-local-variable 'LaTeX-fold-macro-spec-list) + '("[l]" ("linelabel")) + t) + ;; This package relies on lualatex, so check for it: + (TeX-check-engine-add-engines 'luatex) + (TeX-add-symbols + '("DeclareWitness" "xml:id" "rendition" "description" + [ LaTeX-ekdosis-long-key-val LaTeX-ekdosis-declarewitness-options ] + 0) + '("app" [ TeX-arg-key-val LaTeX-ekdosis-app-options ] + t) + '("lem" [ LaTeX-ekdosis-long-key-val LaTeX-ekdosis-lem-options ] + t) + '("rdg" [ LaTeX-ekdosis-long-key-val LaTeX-ekdosis-rdg-options ] + t) + '("note" [ LaTeX-ekdosis-long-key-val LaTeX-ekdosis-note-options ] + t) + '("note*" [ LaTeX-ekdosis-long-key-val LaTeX-ekdosis-note-star-options ] + t) + '("SetEkdosisAlignment" + (TeX-arg-key-val LaTeX-ekdosis-alignment-key-val-options)) + ) + (LaTeX-add-environments + "ekdosis" + '("alignment" LaTeX-env-args + [ TeX-arg-key-val LaTeX-ekdosis-alignment-key-val-options ] + )) + ) + LaTeX-dialect) + +;;; ekdosis.el ends here diff --git a/Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.pdf b/Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.pdf Binary files differnew file mode 100644 index 00000000000..ef69e146fa5 --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.pdf diff --git a/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1-tei.xml b/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1-tei.xml new file mode 100644 index 00000000000..b9e4f9a23ad --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1-tei.xml @@ -0,0 +1,225 @@ +<?xml version="1.0" encoding="utf-8"?> +<TEI xmlns="http://www.tei-c.org/ns/1.0"> + <teiHeader> + <fileDesc> + <titleStmt> + <title> + <!-- Title --> + </title> + <respStmt> + <resp> + <!-- Edited by --> + </resp> + <name> + <!-- Name --> + </name> + </respStmt> + </titleStmt> + <publicationStmt> + <distributor> + <!-- Distributor name --> + </distributor> + </publicationStmt> + <sourceDesc> + <listWit> + <witness xml:id="A"> + <abbr type="siglum">A</abbr> + <emph>Bongarsianus</emph>81 + <msDesc> + <msIdentifier> + <settlement>Amsterdam</settlement> + <institution>University Library</institution> + <idno>81</idno> + <msName> + <emph>Bongarsianus</emph> + </msName> + </msIdentifier> + <physDesc> + <handDesc hands="1"> + <handNote xml:id="A1"> + <abbr type="siglum">A + <hi rend="sup">1</hi></abbr> + <p> + <emph>Emendationes scribae ipsius</emph> + </p> + </handNote> + </handDesc> + </physDesc> + <history> + <origin> + <origDate>s. IX--X</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="M"> + <abbr type="siglum">M</abbr> + <emph>Parisinus Lat.</emph>5056 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. XII</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="B"> + <abbr type="siglum">B</abbr> + <emph>Parisinus Lat.</emph>5763 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. IX--X</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="R"> + <abbr type="siglum">R</abbr> + <emph>Vaticanus Lat.</emph>3864 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. X</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="S"> + <abbr type="siglum">S</abbr> + <emph>Laurentianus</emph>R 33 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. X</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="L"> + <abbr type="siglum">L</abbr> + <emph>Londinensis</emph>Br. Mus. 10084 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. XI</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="N"> + <abbr type="siglum">N</abbr> + <emph>Neapolitanus</emph>IV, c. 11 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. XII</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="T"> + <abbr type="siglum">T</abbr> + <emph>Parisinus Lat.</emph>5764 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. XI</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="f"> + <abbr type="siglum"> + <emph>f</emph> + </abbr> + <emph>Vindobonensis</emph>95 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. XII</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="U"> + <abbr type="siglum">U</abbr> + <emph>Vaticanus Lat.</emph>3324 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. XI</origDate> + </origin> + </history> + </msDesc></witness> + <witness xml:id="l"> + <abbr type="siglum"> + <emph>l</emph> + </abbr> + <emph>Laurentianus</emph>Riccard. 541 + <msDesc> + <msIdentifier /> + <history> + <origin> + <origDate>s. XI--XII</origDate> + </origin> + </history> + </msDesc></witness> + </listWit> + </sourceDesc> + </fileDesc> + <encodingDesc> + <variantEncoding method="parallel-segmentation" + location="internal" /> + </encodingDesc> + </teiHeader> + <text> + <body> + <div xml:id="div-latin_1" xml:lang="la"> + <div type="section" n="6.13"> + <head>XIII</head> + <p>In omni Gallia eorum hominum qui + <app> + <lem wit="#A #M #B #R #S #L #N">aliquo</lem> + <rdg wit="#T #f #U #l">in aliquo</rdg> + </app>sunt numero atque honore genera sunt duo. Nam + plebes paene seruorum habetur loco, quae + <app> + <lem wit="#A #M">nihil audet per se</lem> + <rdg wit="#A1">nihil aut et per se</rdg> + <rdg wit="#R #S #L #N">nihil habet per se</rdg> + <rdg wit="#T #f #U #l">per se nihil audet</rdg> + </app>, + <app> + <lem wit="#A #M #B #R #S #L #N">nullo</lem> + <rdg wit="#T #f #U #l">nulli</rdg> + </app>adhibetur + <app> + <lem>consilio</lem> + <rdg wit="#T #U">concilio</rdg> + </app>.</p> + </div> + </div> + <div xml:id="div-english_1" xml:lang="en"> + <div type="section" n="6.13"> + <head>XIII</head> + <p>Throughout all Gaul there are two orders of those men + who are of any rank and dignity: for the commonality is + held almost in the condition of slaves, and dares to + undertake nothing of itself, and is admitted to no + deliberation.</p> + </div> + </div> + <div xml:id="div-french_1" xml:lang="fr"> + <div type="section" n="6.13"> + <head>XIII</head> + <p>Partout en Gaule il y a deux classes d'hommes qui + comptent et qui sont considérés. Quant aux gens du + peuple, ils ne sont guère traités autrement que des + esclaves, ne pouvant se permettre aucune initiative, + n'étant consultés sur rien.</p> + </div> + </div> + </body> + </text> +</TEI> diff --git a/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.pdf b/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.pdf Binary files differnew file mode 100644 index 00000000000..4f80ccc1372 --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.pdf diff --git a/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.tex b/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.tex new file mode 100644 index 00000000000..8002aec9e23 --- /dev/null +++ b/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.tex @@ -0,0 +1,118 @@ +\documentclass[12pt]{article} +\usepackage{fontspec} +\usepackage[latin.classic,french,english]{babel} +\babelfont{rm}{Old Standard} +\babelfont{sf}{NewComputerModern Sans} +\babelfont{tt}{NewComputerModern Mono} + +\usepackage{nextpage} +\usepackage{xltabular} + +\usepackage[teiexport=tidy]{ekdosis} +\DeclareApparatus{default}[ + delim=\hskip0.75em, + ehook=.] + +\ekdfmtdiv{2}{}{.} + +\SetEkdosisAlignment{ + tcols=3, + lcols=1, + texts=latin[xml:lang="la"]; + english[xml:lang="en"]; + french[xml:lang="fr"], + apparatus=latin, + segmentation=auto} + +\AtBeginEnvironment{latin}{\selectlanguage{latin}} +\AtBeginEnvironment{english}{\sloppy\selectlanguage{english}} +\AtBeginEnvironment{french}{\sloppy\selectlanguage{french}} + +\DeclareWitness{A}{A}{\emph{Bongarsianus} 81}[ + msName=\emph{Bongarsianus}, + settlement=Amsterdam, + idno=81, + institution=University Library, + origDate=s. IX--X] +\DeclareHand{A1}{A}{A\textsuperscript{1}}[\emph{Emendationes + scribae ipsius}] +\DeclareWitness{M}{M}{\emph{Parisinus Lat.} 5056}[ + origDate={s. XII}] +\DeclareWitness{B}{B}{\emph{Parisinus Lat.} 5763}[ + origDate={s. IX--X}] +\DeclareWitness{R}{R}{\emph{Vaticanus Lat.} 3864}[ + origDate={s. X}] +\DeclareWitness{S}{S}{\emph{Laurentianus} R 33}[ + origDate={s. X}] +\DeclareWitness{L}{L}{\emph{Londinensis} Br. Mus. 10084}[ + origDate={s. XI}] +\DeclareWitness{N}{N}{\emph{Neapolitanus} IV, c. 11}[ + origDate={s. XII}] +\DeclareWitness{T}{T}{\emph{Parisinus Lat.} 5764}[ + origDate={s. XI}] +\DeclareWitness{f}{\emph{f}}{\emph{Vindobonensis} 95}[ + origDate={s. XII}] +\DeclareWitness{U}{U}{\emph{Vaticanus Lat.} 3324}[ + origDate={s. XI}] +\DeclareWitness{l}{\emph{l}}{\emph{Laurentianus} Riccard. 541}[ + origDate={s. XI--XII}] +\DeclareShorthand{a}{α}{A,M,B,R,S,L,N} +\DeclareShorthand{b}{β}{T,f,U,l} + +\begin{document} + +\begin{xltabular}[c]{0.75\linewidth}{lXl} + \caption*{\textbf{Conspectus siglorum}\label{tab:conspectus-siglorum}}\\ + \multicolumn{3}{c}{\emph{Familia} \getsiglum{a}}\\ + \SigLine{A}\\ + & \getsiglum{A1} \emph{Emendationes scribae ipsius} & \\ + \SigLine{M}\\ + \SigLine{B}\\ + \SigLine{R}\\ + \SigLine{S}\\ + \SigLine{L}\\ + \SigLine{N}\\ + \multicolumn{3}{c}{\emph{Familia} \getsiglum{b}}\\ + \SigLine{T}\\ + \SigLine{f}\\ + \SigLine{U}\\ + \SigLine{l}\\ +\end{xltabular} + +\cleartoevenpage + +\begin{alignment} + \begin{latin} + \ekddiv{head=XIII, depth=2, n=6.13, type=section} + In omni Gallia eorum hominum qui \app{ + \lem[wit=a]{aliquo} + \rdg[wit=b, alt=in al-]{in aliquo}} + sunt numero atque honore genera sunt duo. Nam plebes paene + seruorum habetur loco, quae \app{ + \lem[wit={A,M}, alt={nihil audet (aut et \getsiglum{A1}) + per se}]{nihil audet per se} + \rdg[wit=A1,nordg]{nihil aut et per se} + \rdg[wit={R,S,L,N}]{nihil habet per se} + \rdg[wit=b]{per se nihil audet}}, \app{ + \lem[wit=a]{nullo} + \rdg[wit=b]{nulli}} adhibetur \app{ + \lem{consilio} + \rdg[wit={T, U}, alt=conc-]{concilio}}. + \end{latin} + \begin{english} + \ekddiv{head=XIII, depth=2, n=6.13, type=section} + Throughout all Gaul there are two orders of those men who are of + any rank and dignity: for the commonality is held almost in the + condition of slaves, and dares to undertake nothing of itself, + and is admitted to no deliberation. + \end{english} + \begin{french} + \ekddiv{head=XIII, depth=2, n=6.13, type=section} + Partout en Gaule il y a deux classes d'hommes qui comptent et qui + sont considérés. Quant aux gens du peuple, ils ne sont guère + traités autrement que des esclaves, ne pouvant se permettre aucune + initiative, n'étant consultés sur rien. + \end{french} +\end{alignment} + +\end{document} |