Skip to content

Commit 396fe5a

Browse files
rbujraveit65
rbuj
authored and
raveit65
committed
Use ITS in docbook article info, validate with dbits schemas
-= Validate =- wget https://docbook.org/xml/5.0/rng/dbits.rng xmllint --noout --relaxng dbits.rng help/C/index.docbook jing dbits.rng help/C/index.docbook -= View the manual using yelp =- yelp file:///path_to_file/index.docbook -= Tests: Generate pdf and html files from docbook =- Method I: Use yelp-build (HTML chunk) cd help/C mkdir htmlout yelp-build html -o htmlout index.docbook Method II-a: Use docbook5-style-xsl package on Fedora 29 (PDF) sudo dnf install -y docbook5-style-xsl cd help/C xsltproc /usr/share/sgml/docbook/xsl-ns-stylesheets-1.79.2/fo/docbook.xsl index.docbook > pluma.fo fop -fo pluma.fo -pdf pluma.pdf Method II-b: Use docbook5-style-xsl package on Fedora 29 (HTML) sudo dnf install -y docbook5-style-xsl cd help/C xsltproc /usr/share/sgml/docbook/xsl-ns-stylesheets-1.79.2/html/docbook.xsl index.docbook > index.html Method II-c: Use docbook5-style-xsl package on Fedora 29 (HTML chunk) sudo dnf install -y docbook5-style-xsl cd help/C xsltproc --xinclude \ --stringparam base.dir htmlout/ \ --stringparam use.id.as.filename 1 \ --stringparam chunker.output.encoding UTF-8 \ /usr/share/sgml/docbook/xsl-ns-stylesheets-1.79.2/html/chunk.xsl index.docbook or xsltproc --xinclude \ --stringparam base.dir htmlout/ \ --stringparam use.id.as.filename 1 \ --stringparam chunker.output.encoding UTF-8 \ --stringparam chunk.section.depth 2 \ --stringparam chunk.first.sections 1 \ /usr/share/sgml/docbook/xsl-ns-stylesheets-1.79.2/html/chunk.xsl index.docbook cp -rp figures htmlout Method III-a: Use docbook-xslt2-2.3.10-app (XHTML) cd help/C wget https://github.com/docbook/xslt20-stylesheets/releases/download/2.3.10/docbook-xslt2-2.3.10-app.zip unzip docbook-xslt2-2.3.10-app.zip java -jar docbook-xslt2-2.3.10-app/docbook-xslt2-2.3.10.jar -f xhtml index.docbook > index.html It doesn't work: Method III-b: Use docbook-xslt2-2.3.10-app (PDF) cd help/C wget https://github.com/docbook/xslt20-stylesheets/releases/download/2.3.10/docbook-xslt2-2.3.10-app.zip unzip docbook-xslt2-2.3.10-app.zip java -jar docbook-xslt2-2.3.10-app/docbook-xslt2-2.3.10.jar -f foprint index.docbook > pluma.fo fop -fo pluma.fo -pdf pluma.pdf
1 parent 82638e2 commit 396fe5a

File tree

2 files changed

+779
-829
lines changed

2 files changed

+779
-829
lines changed

‎help/C/index.docbook‎

Lines changed: 58 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2+
<?xml-model href="http://docbook.org/xml/5.0/rng/dbits.rng" schematypens="http://relaxng.org/ns/structure/1.0"?>
23
<!--
34
(Do not remove this comment block.)
45
Maintained by the MATE Documentation Project
@@ -18,21 +19,21 @@
1819
<info>
1920
<title>Pluma Manual</title>
2021

21-
<copyright>
22+
<copyright its:translate="no">
2223
<year>2015</year>
2324
<holder>MATE Documentation Project</holder>
2425
</copyright>
25-
<copyright>
26+
<copyright its:translate="no">
2627
<year>2007</year>
2728
<holder>GNOME Documentation Project</holder>
2829
</copyright>
29-
<copyright>
30+
<copyright its:translate="no">
3031
<year>2002</year>
3132
<year>2003</year>
3233
<year>2004</year>
3334
<holder>Sun Microsystems</holder>
3435
</copyright>
35-
<copyright>
36+
<copyright its:translate="no">
3637
<year>2000</year>
3738
<holder>Eric Baudais</holder>
3839
</copyright>
@@ -46,11 +47,11 @@
4647

4748
<xi:include href="legal.xml"/>
4849

49-
<authorgroup>
50+
<authorgroup its:translate="no">
5051
<author>
51-
<orgname>MATE Documentation Project</orgname>
52+
<orgname its:translate="yes">MATE Documentation Project</orgname>
5253
<affiliation>
53-
<orgname>MATE Desktop</orgname>
54+
<orgname its:translate="yes">MATE Desktop</orgname>
5455
</affiliation>
5556
</author>
5657
<author>
@@ -60,22 +61,22 @@
6061
</personname>
6162
</author>
6263
<author>
63-
<orgname>GNOME Documentation Project</orgname>
64+
<orgname its:translate="yes">GNOME Documentation Project</orgname>
6465
<affiliation>
65-
<orgname>GNOME</orgname>
66+
<orgname its:translate="yes">GNOME</orgname>
6667
</affiliation>
6768
</author>
6869
<author>
6970
<personname>
7071
<firstname>Hal</firstname>
7172
<surname>Canary</surname>
7273
</personname>
73-
<contrib>Added the Shortcut Keys Table</contrib>
74+
<contrib its:translate="yes">Added the Shortcut Keys Table</contrib>
7475
</author>
7576
<author>
76-
<orgname>Sun Java Desktop System Documentation Team</orgname>
77+
<orgname its:translate="yes">Sun Java Desktop System Documentation Team</orgname>
7778
<affiliation>
78-
<orgname>Sun Microsystems</orgname>
79+
<orgname its:translate="yes">Sun Microsystems</orgname>
7980
</affiliation>
8081
<email>gdocteam@sun.com</email>
8182
</author>
@@ -85,7 +86,7 @@
8586
<surname>Baudais</surname>
8687
</personname>
8788
<affiliation>
88-
<orgname>GNOME Documentation Project</orgname>
89+
<orgname its:translate="yes">GNOME Documentation Project</orgname>
8990
</affiliation>
9091
<email>baudais@okstate.edu</email>
9192
</author>
@@ -94,116 +95,116 @@
9495
<firstname>Baris</firstname>
9596
<surname>Cicek</surname>
9697
</personname>
97-
<contrib>Provided information from earlier revisions of the pluma application.</contrib>
98+
<contrib its:translate="yes">Provided information from earlier revisions of the pluma application.</contrib>
9899
</othercredit>
99100
<othercredit role="other">
100101
<personname>
101102
<firstname>George</firstname>
102103
<surname>Ajit</surname>
103104
</personname>
104-
<contrib>Provided information about plugins.</contrib>
105+
<contrib its:translate="yes">Provided information about plugins.</contrib>
105106
</othercredit>
106107
</authorgroup>
107108

108109
<!-- According to GNU FDL, revision history is mandatory if you are
109110
modifying/reusing someone else's document. If not, you can omit it. -->
110-
<revhistory>
111+
<revhistory its:translate="no">
111112
<!-- Remember to remove the &manrevision; entity from the revision
112113
entries other than the current revision. -->
113114
<revision>
114115
<revnumber>1.0</revnumber>
115116
<date>2000</date>
116117
<revdescription>
117-
<para role="author">Eric Baudais <email>baudais@okstate.edu</email></para>
118-
<para role="publisher">GNOME Documentation Project</para>
118+
<para role="author" its:translate="no">Eric Baudais <email>baudais@okstate.edu</email></para>
119+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
119120
</revdescription>
120121
</revision>
121122
<revision>
122123
<revnumber>2.0</revnumber>
123-
<date>March 2002</date>
124+
<date its:translate="yes">March 2002</date>
124125
<revdescription>
125-
<para role="author">Sun GNOME Documentation Team</para>
126-
<para role="publisher">GNOME Documentation Project</para>
126+
<para role="author" its:translate="yes">Sun GNOME Documentation Team</para>
127+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
127128
</revdescription>
128129
</revision>
129130
<revision>
130131
<revnumber>2.1</revnumber>
131-
<date>June 2002</date>
132+
<date its:translate="yes">June 2002</date>
132133
<revdescription>
133-
<para role="author">Sun GNOME Documentation Team</para>
134-
<para role="publisher">GNOME Documentation Project</para>
134+
<para role="author" its:translate="yes">Sun GNOME Documentation Team</para>
135+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
135136
</revdescription>
136137
</revision>
137138
<revision>
138139
<revnumber>2.2</revnumber>
139-
<date>August 2002</date>
140+
<date its:translate="yes">August 2002</date>
140141
<revdescription>
141-
<para role="author">Sun GNOME Documentation Team</para>
142-
<para role="publisher">GNOME Documentation Project</para>
142+
<para role="author" its:translate="yes">Sun GNOME Documentation Team</para>
143+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
143144
</revdescription>
144145
</revision>
145146
<revision>
146147
<revnumber>2.3</revnumber>
147-
<date>September 2002</date>
148+
<date its:translate="yes">September 2002</date>
148149
<revdescription>
149-
<para role="author">Sun GNOME Documentation Team</para>
150-
<para role="publisher">GNOME Documentation Project</para>
150+
<para role="author" its:translate="yes">Sun GNOME Documentation Team</para>
151+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
151152
</revdescription>
152153
</revision>
153154
<revision>
154155
<revnumber>2.4</revnumber>
155-
<date>January 2003</date>
156+
<date its:translate="yes">January 2003</date>
156157
<revdescription>
157-
<para role="author">Sun GNOME Documentation Team</para>
158-
<para role="publisher">GNOME Documentation Project</para>
158+
<para role="author" its:translate="yes">Sun GNOME Documentation Team</para>
159+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
159160
</revdescription>
160161
</revision>
161162
<revision>
162163
<revnumber>2.5</revnumber>
163-
<date>March 2003</date>
164+
<date its:translate="yes">March 2003</date>
164165
<revdescription>
165-
<para role="author">Sun GNOME Documentation Team</para>
166-
<para role="publisher">GNOME Documentation Project</para>
166+
<para role="author" its:translate="yes">Sun GNOME Documentation Team</para>
167+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
167168
</revdescription>
168169
</revision>
169170
<revision>
170171
<revnumber>2.6</revnumber>
171-
<date>September 2003</date>
172+
<date its:translate="yes">September 2003</date>
172173
<revdescription>
173-
<para role="author">Sun GNOME Documentation Team</para>
174-
<para role="publisher">GNOME Documentation Project</para>
174+
<para role="author" its:translate="yes">Sun GNOME Documentation Team</para>
175+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
175176
</revdescription>
176177
</revision>
177178
<revision>
178179
<revnumber>2.7</revnumber>
179-
<date>March 2004</date>
180+
<date its:translate="yes">March 2004</date>
180181
<revdescription>
181-
<para role="author">Sun GNOME Documentation Team</para>
182-
<para role="publisher">GNOME Documentation Project</para>
182+
<para role="author" its:translate="yes">Sun GNOME Documentation Team</para>
183+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
183184
</revdescription>
184185
</revision>
185186
<revision>
186187
<revnumber>2.8</revnumber>
187-
<date>July 2015</date>
188+
<date its:translate="yes">July 2015</date>
188189
<revdescription>
189-
<para role="author">Sun Java Desktop System Documentation Team</para>
190-
<para role="publisher">GNOME Documentation Project</para>
190+
<para role="author" its:translate="yes">Sun Java Desktop System Documentation Team</para>
191+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
191192
</revdescription>
192193
</revision>
193194
<revision>
194195
<revnumber>2.9</revnumber>
195-
<date>July 2006</date>
196+
<date its:translate="yes">July 2006</date>
196197
<revdescription>
197-
<para role="author">GNOME Documentation Team</para>
198-
<para role="publisher">GNOME Documentation Project</para>
198+
<para role="author" its:translate="yes">GNOME Documentation Team</para>
199+
<para role="publisher" its:translate="yes">GNOME Documentation Project</para>
199200
</revdescription>
200201
</revision>
201202
<revision>
202203
<revnumber>3.0</revnumber>
203-
<date>July 2015</date>
204+
<date its:translate="yes">July 2015</date>
204205
<revdescription>
205-
<para role="author">MATE Documentation Team</para>
206-
<para role="publisher">MATE Documentation Project</para>
206+
<para role="author" its:translate="yes">MATE Documentation Team</para>
207+
<para role="publisher" its:translate="yes">MATE Documentation Project</para>
207208
</revdescription>
208209
</revision>
209210
</revhistory>
@@ -267,17 +268,17 @@
267268
</info>
268269
<para>When you start <application>pluma</application>, the following window is displayed:</para>
269270

270-
<figure xml:id="pluma-window">
271+
<figure xml:id="pluma-window" its:translate="no">
271272
<info>
272-
<title>pluma Window</title>
273+
<title its:translate="yes">pluma Window</title>
273274
</info>
274275
<screenshot>
275276
<mediaobject>
276277
<imageobject>
277278
<imagedata fileref="figures/pluma_window.png" format="PNG"/>
278279
</imageobject>
279280
<textobject>
280-
<phrase>Shows pluma main window.</phrase>
281+
<phrase its:translate="yes">Shows pluma main window.</phrase>
281282
</textobject>
282283
</mediaobject>
283284
</screenshot>
@@ -370,12 +371,12 @@
370371
<title>Opening a File</title>
371372
</info>
372373
<para>To open a file, choose <menuchoice> <guimenu>File</guimenu> <guimenuitem>Open</guimenuitem> </menuchoice> to display the <guilabel>Open File</guilabel> dialog. Select the file that you want to open, then click <guibutton>Open</guibutton>. The file is displayed in the <application>pluma</application> window.</para>
373-
<para>The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the <menuchoice> <guimenu>File</guimenu> </menuchoice> menu. You can also click on the <inlinemediaobject>
374+
<para>The application records the paths and filenames of the five most recent files that you edited and displays the files as menu items on the <menuchoice> <guimenu>File</guimenu> </menuchoice> menu. You can also click on the <inlinemediaobject its:translate="no">
374375
<imageobject>
375376
<imagedata fileref="figures/pluma_recent_files_menu_icon.png" format="PNG"/>
376377
</imageobject>
377378
<textobject>
378-
<phrase>Shows Recent Files menu icon.</phrase>
379+
<phrase its:translate="yes">Shows Recent Files menu icon.</phrase>
379380
</textobject>
380381
</inlinemediaobject> icon on the toolbar to display the list of recent files.</para>
381382
<note>
@@ -2545,4 +2546,4 @@
25452546
</orderedlist>
25462547
</section>
25472548
</section>
2548-
</article>
2549+
</article>

0 commit comments

Comments
 (0)