summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/reledmac/README
blob: 3260f4169f6a7a694f668c1fac818dee14a4fc99 (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
121
122
123
124
125
Overview
========

The reledmac package is for typesetting critical editions. The reledpar
package is an extension of reledmac enabling parallel typesetting in
columns or on facing pages.

Reledmac and reledpar are successors of eledmac and eledpar, which were
successor of ledmac and ledpar. Ledmac was a LaTeX port, and extension,
of the plain TeX EDMAC, TABMAC and EDSTANZA macros.

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

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),
-   reledmac.dtx,
-   reledmac.ins,
-   reledpar.dtx,
-   reledpar.ins,

and the derived files:

-   reledmac.sty,
-   reledpar.sty,
-   reledmac.pdf, (200+ pages)
-   reledpar.pdf, (100+ pages)

The distribution consists of the following files:

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

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

-   run: `latex reledmac.ins` (which will generate `reledmac.sty`) and
    `latex reledpar.ins` (which will generate `reledmac.sty`)
-   move `reledmac.sty` and `reledpar.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 reledmac.pdf && make reledpar.pdf`

Help
====

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

Debug and feature requests
==========================

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 for each problem*, even if problems are similar.
-   You can write or in English, or better, in French if it is your
    native language.
-   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 ask
    you to test the new branch:
    -   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.
        -   Choose "Download zip" in the "Clone or download" menu, on
            the right side.
        -   Unzip the file
    -   Run the `.ins` files with pdflatex, to obtain the `.sty` files.
    -   Put the `.sty` files with your test files (in the same folder).
    -   Look on file issueXXX.tex get a MWE of the new feature.
    -   Make your report.