From 637224a93d20e487f3ba4cdc5040a68c86fb6617 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 8 Jul 2020 21:18:08 +0000 Subject: ekdosis (8jul20) git-svn-id: svn://tug.org/texlive/trunk@55786 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/lualatex/ekdosis/README.md | 130 ++++++++++++ Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.el | 150 ++++++++++++++ Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.pdf | Bin 0 -> 362094 bytes .../ekdosis/samples/Caesar_BG-6-13-1-tei.xml | 225 +++++++++++++++++++++ .../lualatex/ekdosis/samples/Caesar_BG-6-13-1.pdf | Bin 0 -> 17989 bytes .../lualatex/ekdosis/samples/Caesar_BG-6-13-1.tex | 118 +++++++++++ 6 files changed, 623 insertions(+) create mode 100644 Master/texmf-dist/doc/lualatex/ekdosis/README.md create mode 100644 Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.el create mode 100644 Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.pdf create mode 100644 Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1-tei.xml create mode 100644 Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.pdf create mode 100644 Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.tex (limited to 'Master/texmf-dist/doc/lualatex') 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, +, 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: + +- website: + +- comments, feature requests, bug reports: + + +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 . + +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 for + more on this. + +Development, Git Repository +=========================== + +Browse the Code +--------------- +You can browse icite repository on the web: + + +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 +--------------------------------------- + + + +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 and navigate (while logged in) +to . 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 + +;; 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 +;; . + +(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 new file mode 100644 index 00000000000..ef69e146fa5 Binary files /dev/null and b/Master/texmf-dist/doc/lualatex/ekdosis/ekdosis.pdf differ 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 @@ + + + + + + + <!-- Title --> + + + + + + + + + + + + + + + + + + + A + Bongarsianus81 + + + Amsterdam + University Library + 81 + + Bongarsianus + + + + + + A + 1 +

+ Emendationes scribae ipsius +

+
+
+
+ + + s. IX--X + + +
+ + M + Parisinus Lat.5056 + + + + + s. XII + + + + + B + Parisinus Lat.5763 + + + + + s. IX--X + + + + + R + Vaticanus Lat.3864 + + + + + s. X + + + + + S + LaurentianusR 33 + + + + + s. X + + + + + L + LondinensisBr. Mus. 10084 + + + + + s. XI + + + + + N + NeapolitanusIV, c. 11 + + + + + s. XII + + + + + T + Parisinus Lat.5764 + + + + + s. XI + + + + + + f + + Vindobonensis95 + + + + + s. XII + + + + + U + Vaticanus Lat.3324 + + + + + s. XI + + + + + + l + + LaurentianusRiccard. 541 + + + + + s. XI--XII + + + +
+
+
+ + + +
+ + +
+
+ XIII +

In omni Gallia eorum hominum qui + + aliquo + in aliquo + sunt numero atque honore genera sunt duo. Nam + plebes paene seruorum habetur loco, quae + + nihil audet per se + nihil aut et per se + nihil habet per se + per se nihil audet + , + + nullo + nulli + adhibetur + + consilio + concilio + .

+
+
+
+
+ XIII +

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.

+
+
+
+
+ XIII +

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.

+
+
+ +
+
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 new file mode 100644 index 00000000000..4f80ccc1372 Binary files /dev/null and b/Master/texmf-dist/doc/lualatex/ekdosis/samples/Caesar_BG-6-13-1.pdf differ 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} -- cgit v1.2.3