summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/eledmac/README
blob: fa8cb6f485160ec37e23337080085e85afa67278 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
Overview
========

The eledmac package is for typesetting critical editions. It is a LaTeX
port, and extension, of the plain TeX EDMAC, TABMAC and EDSTANZA macros.
The eledpar package is an extension of eledmac enabling parallel
typesetting in columns or on facing pages.

Eledmac and eledpar are successors of ledmac and ledpar.

The package is available on [CTAN](http://www.ctan.org/pkg/eledmac).

Copyright and Licence
=====================

Authors
-------

-   Peter Wilson (Herries Press) herries dot press at earthlink dot net,
-   Maïeul Rouquette (new maintainer since june 2011)

Copyright
---------

-   Copyright 2003 --- 2005 Peter R. Wilson
-   Copyright 2011 --- .. Maïeul Rouquette

Licence
-------

This work may be distributed and/or modified under the conditions of the
LaTeX Project Public License, either version 1.3 of this license or (at
your option) any later version.

The latest version of the license is in
<http://www.latex-project.org/lppl.txt> and version 1.3 or later is part
of all distributions of LaTeX version 2003/06/01 or later.

This work has the LPPL maintenance status "maintained".

This work consists of the files:

-   README (this file),
-   eledmac.dtx,
-   eledmac.ins,
-   eledpar.dtx,
-   eledpar.ins,

and the derived files:

-   eledmac.sty,
-   eledpar.sty,
-   eledmac.pdf, (200+ pages)
-   eledpar.pdf, (100+ pages)

The distribution consists of the following files:

-   README (this file)
-   eledmac.dtx
-   eledmac.ins
-   eledmac.pdf
-   eledpar.dtx
-   eledpar.ins
-   eledpar.pdf
-   makefile
-   latexmrc
-   examples/
    -   \*.tex
    -   \*.pdf
    -   makefile

Installation
============

-   run: `latex eledmac.ins` (which will generate eledmac.sty) and
    `latex eledpar.ins` (which will generate eledmac.sty)
-   move eledmac.sty and eledpar.sty to a location where LaTeX will find
    it (for more information on this see the FAQ).

To generate a second copy of the manual (which is already supplied as a
PDF file):

-   run: `make eledmac.pdf`

Help
====

-   [Users list](http://geekographie.maieul.net/146)
-   [StackExchange](https://tex.stackexchange.com/questions/tagged/eledmac),
    see also the [older
    tag](https://tex.stackexchange.com/questions/tagged/eledmac)

Debug
=====

Suggestions and bug reports are welcome.

Maïeul Rouquette is the only one maintainer. To help him in his work,
please follow these rules:

-   Go to the [issues page](https://github.com/maieul/ledmac/issues).
-   Open *one issue by problem*, even if problems are similar.
-   Add a [minimal working
    example](http://www.tex.ac.uk/cgi-bin/texfaq2html?label=minxampl).
-   If your report is really a bug, Maïeul Rouquette will open a
    "branch" to solve your problem. This branch will be called
    "issueXXX", where "XXX" is the issue number.
-   Once the problem has a possible solution, Maïeul Rouquette will send
    you a zip file and ask you to test it:
    -   Download the zip file of the branch (or, if you know Git, go to
        the branch there):
        -   Go to [the project page](https://github.com/maieul/ledmac/).
        -   Choose the correct branch in the "branch" menu.
        -   Click on the cloud, in the right side.

    -   Run the `.ins` files with pdflatex, to obtain the `.sty` files.
    -   Put the `.sty` files with your test files (in the same folder).
    -   Make your report.