summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/reledmac/README.md
blob: 4abb2fcf12545bcec97217df440c70a15d91d4c7 (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
# 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](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 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.

# Bibliography

We maintain two collaborative bibliographies:

- [Critical Editions Typeset with EDMAC, LEDMAC and eLEDMAC](https://www.zotero.org/groups/209265/)
- [Articles and books about (r)(e)(l)edmac](https://www.zotero.org/groups/1024519/)