forked from mquinson/po4a
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
101 lines (71 loc) · 3.05 KB
/
README
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
Introduction to Po4a
====================
The po4a (PO for anything) project goal is to ease translations (and
more interestingly, the maintenance of translations) using gettext
tools on areas where they were not expected like documentation.
In po4a each documentation format is handled by a module. For now, we have a
module for the following formats:
- asciidoc: AsciiDoc format.
- dia: uncompressed Dia diagrams.
- docbook: DocBook XML.
- guide: Gentoo Linux's XML documentation format.
- ini: INI format.
- kernelhelp: Help messages of each kernel compilation option.
- latex: LaTeX format.
- man: Good old manual page format.
- pod: Perl Online Documentation format.
- sgml: either DebianDoc or DocBook DTD.
- texinfo: The info page format.
- tex: generic TeX documents (see also latex).
- text: simple text document.
- wml: WML documents.
- xhtml: XHTML documents.
- xml: generic XML documents (see also docbook).
INSTALLATION
To install this module type the following:
perl Build.PL
./Build
./Build install
USE WITHOUT INSTALLATION
If you want to use a version without installing it (e.g. directly from
the git tree), use the PERLLIB environment variable as such:
PERLLIB=~/git-checkouts/po4a/lib ~/git-checkouts/po4a/po4a-gettextize [usual args]
PO4A DEPENDENCIES
Locale::gettext (v1.01):
This module being itself internationalized, it needs the Locale::gettext
library to translate its own messages.
If it is not present, then po4a's messages won't be translated, but
po4a will remain fully functional.
Text::WrapI18N:
This module is used to format po4a's warnings and error messages. It
permits to wrap long error messages without splitting words.
If it is not present, the formatting of messages will be different,
but po4a will remain fully functional.
Term::ReadKey:
This module is used to retrieve the terminal's line width. It is not
used if Text::WrapI18N is not available.
If it is not present, the line width can be specified with the COLUMN
environment variable.
SGML MODULE SPECIFIC DEPENDENCIES
SGMLS (1.03ii):
This is a set of Perl5 routines for processing the output from the onsgmls
SGML parser.
opensp (1.5.2): OpenJade group's SGML parsing tools
This is the SGML parser we use.
TEXT MODULE SPECIFIC DEPENDENCIES
Unicode::GCString:
This module is used to compute text width; it is needed by AsciiDoc to
determine two line titles in encodings different from ASCII.
http://hatuka.nezumi.nu/repos/Unicode-LineBreak/
PROJECT HOSTING
The po4a project is hosted mainly on alioth:
- Webpage: http://po4a.alioth.debian.org
- Source code: https://alioth.debian.org/scm/?group_id=30267
- Bug tracker: https://alioth.debian.org/tracker/?atid=410622&group_id=30267&func=browse
COPYRIGHT AND LICENSE
This program is free software; you may redistribute it and/or modify it
under the terms of GPL (see COPYING file).
Copyright (C) 2002-2O16 by SPI, inc.
Authors:
Denis Barbier <[email protected]>
Martin Quinson (mquinson#debian.org)