docs-commits January 2006

docs-commits@lists.fedoraproject.org

1 participants
215 discussions

docs-common Makefile.common,1.36,1.37
by fedora-docs-commits＠redhat.com 31 Jan '06

31 Jan '06

Author: jtr Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14321 Modified Files: Makefile.common Log Message: Doh! Now the "make DRAFT=no html" or "make DRAFT=yes html" actually work. Defaults to "make DRAFT=yes". Index: Makefile.common =================================================================== RCS file: /cvs/docs/docs-common/Makefile.common,v retrieving revision 1.36 retrieving revision 1.37 diff -u -r1.36 -r1.37 --- Makefile.common 30 Jan 2006 10:32:17 -0000 1.36 +++ Makefile.common 31 Jan 2006 17:58:20 -0000 1.37 @@ -33,28 +33,28 @@ ######################################################################### # Supply default values for the boilerplate files _unless_ the user has # provided their own values. -ifeq (${FDPDIR},) +ifeq "${FDPDIR}" "" FDPDIR = $(PWD)/.. endif -ifeq (${FDPBIN},) +ifeq "${FDPBIN}" "" FDPBIN = ${FDPDIR}/docs-common/bin endif -ifeq (${XSLPDF},) +ifeq "${XSLPDF}" "" XSLPDF = ${FDPDIR}/docs-common/xsl/main-pdf.xsl endif -ifeq (${XSLHTML},) +ifeq "${XSLHTML}" "" XSLHTML = ${FDPDIR}/docs-common/xsl/main-html.xsl endif -ifeq (${XSLHTMLNOCHUNKS},) +ifeq "${XSLHTMLNOCHUNKS}" "" XSLHTMLNOCHUNKS = ${FDPDIR}/docs-common/xsl/main-html-nochunks.xsl endif -ifeq (${HTMLCSS},) +ifeq "${HTMLCSS}" "" HTMLCSS = ${FDPDIR}/docs-common/css/fedora-draft.css endif -ifeq (${DRAFT},) +ifeq "${DRAFT}" "" DRAFT = yes endif -ifeq (${RPMINFO},) +ifeq "${RPMINFO}" "" RPMINFO = ${PWD}/rpm-info.xml endif ######################################################################### @@ -122,8 +122,8 @@ mkdir -p $(DOCBASE)-$(1)/stylesheet-images/ cp ${FDPDIR}/docs-common/stylesheet-images/*.png $(DOCBASE)-$(1)/stylesheet-images cp ${HTMLCSS} $(DOCBASE)-$(1)/fedora.css -ifeq (${DRAFT},"yes") - cp ${FDPDIR}/docs-common/images/watermark-$(1).png +ifeq "${DRAFT}" "yes" + cp ${FDPDIR}/docs-common/images/watermark-$(1).png $(DOCBASE)-$(1)/watermark.png endif [ ! -d figs ] || copy-figs -v -f '*.png' \ -l $(1) figs $(DOCBASE)-$(1)

1 0

translation-quick-start-guide rpm-info.xml,1.7,1.8
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: tombo Update of /cvs/docs/translation-quick-start-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv30256/translation-quick-start-guide Modified Files: rpm-info.xml Log Message: correction to details tag Index: rpm-info.xml =================================================================== RCS file: /cvs/docs/translation-quick-start-guide/rpm-info.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- rpm-info.xml 30 Jan 2006 20:26:17 -0000 1.7 +++ rpm-info.xml 30 Jan 2006 20:31:58 -0000 1.8 @@ -58,7 +58,7 @@ <revision date="Wed Jan 18 2006" number="0.0.1" role="doc"> <author worker="ManuelOspina"/> <details lang="en">First draft</details> - <details lang="en">Prima bozza</details> + <details lang="it">Prima bozza</details> </revision> </changelog> </rpm-info>

1 0

translation-quick-start-guide rpm-info.xml,1.6,1.7
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: tombo Update of /cvs/docs/translation-quick-start-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv30140/translation-quick-start-guide Modified Files: rpm-info.xml Log Message: updated italian string Index: rpm-info.xml =================================================================== RCS file: /cvs/docs/translation-quick-start-guide/rpm-info.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- rpm-info.xml 30 Jan 2006 18:37:23 -0000 1.6 +++ rpm-info.xml 30 Jan 2006 20:26:17 -0000 1.7 @@ -41,6 +41,7 @@ <revision date="2006-01-30" number="0.2.1" role="doc"> <author worker="PaulWFrields"/> <details lang="en">Fix hostname error</details> + <details lang="it">Risolto errore hostname</details> </revision> <revision date="2006-01-25" number="0.2" role="doc"> <author worker="PaulWFrields"/>

1 0

example-tutorial example-tutorial-en.xml,1.23,1.24
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: jtr Update of /cvs/docs/example-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv27328 Modified Files: example-tutorial-en.xml Log Message: Oops, too quick to commit the good news; remove the <xi:include> usage blurb since it doesn't belong here: just the usage is appropriate. Index: example-tutorial-en.xml =================================================================== RCS file: /cvs/docs/example-tutorial/example-tutorial-en.xml,v retrieving revision 1.23 retrieving revision 1.24 diff -u -r1.23 -r1.24 --- example-tutorial-en.xml 30 Jan 2006 19:11:23 -0000 1.23 +++ example-tutorial-en.xml 30 Jan 2006 19:17:05 -0000 1.24 @@ -165,41 +165,6 @@ </procedure> </section> - <section id="sn-external-files"> - <title>Including External Files</title> - - <para> - An alternative to declaring and using system entities to obtain - the content from other files is to use an - <firstterm>XInclude</firstterm> reference. These work similarly to - include files in familiar programming languages. Using the - XInclude feature allows an entire file, or just a part of it, to - be copied into the current document. External files are referenced - using an <abbrev>URI</abbrev> so they may be located anywhere, - even across the Internet. - </para> - - <para> - The official documentation for the XInclude feature may be found - at the <ulink url="http://www.w3.org/TR/XInclude"/> web site. A - somewhat dated description at - <ulink url="http://www.sagehill.net/docbookxsl/ModularDoc.html"/> - may be a more readible starting reference. - </para> - - <para> - Using the XInclude facility with DocBook requires a special - technique to allow the document to pass XML validation. Often - examples show adding the phrase - <phrase>xmlns:xi="http://www.w3.org/2001/XInclude"</phrase> - to a top-level element such as - <wordasword><chapter></wordasword>. Unfortunately this - causes the DocBook file to fail validation. The solution is to - place the namespace declaration directly in the <xi:include> - element: - </para> - </section> - <index id="generated-index"></index> </article>

1 0

example-tutorial para-en.xml,1.1,1.2
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: jtr Update of /cvs/docs/example-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv27256 Modified Files: para-en.xml Log Message: When using the <xi:include> construct to obtain content from an external XML file, that file can include its own <!DOCTYPE> element. Any entities defined in the external file must exactly match the same entity declared in the main document, if any. Entities defined in the external file are NOT visible in the including document. Index: para-en.xml =================================================================== RCS file: /cvs/docs/example-tutorial/para-en.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- para-en.xml 30 Jan 2006 19:11:23 -0000 1.1 +++ para-en.xml 30 Jan 2006 19:14:32 -0000 1.2 @@ -1,3 +1,12 @@ + + +<!DOCTYPE para PUBLIC "-//OASIS//DTD DocBook V4.2//EN" + "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ + + <!ENTITY BOILERPLATE "This header makes editing XML easier" > + +]> + <para> This paragraph was obtained via an <wordasword><xi:include></wordasword> element, just for an

1 0

example-tutorial para-en.xml, NONE, 1.1 Makefile, 1.26, 1.27 example-tutorial-en.xml, 1.22, 1.23
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: jtr Update of /cvs/docs/example-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv27221 Modified Files: Makefile example-tutorial-en.xml Added Files: para-en.xml Log Message: Utilize the proper <xi:include> idiom to obtain the content of some useless paragraph. --- NEW FILE para-en.xml --- <para> This paragraph was obtained via an <wordasword><xi:include></wordasword> element, just for an example. </para> Index: Makefile =================================================================== RCS file: /cvs/docs/example-tutorial/Makefile,v retrieving revision 1.26 retrieving revision 1.27 diff -u -r1.26 -r1.27 --- Makefile 17 Jan 2006 21:11:02 -0000 1.26 +++ Makefile 30 Jan 2006 19:11:23 -0000 1.27 @@ -16,6 +16,7 @@ # LANGUAGES = en de DOCBASE = example-tutorial +XMLEXTRAFILES-en= para-en.xml # ###################################################### include ../docs-common/Makefile.common Index: example-tutorial-en.xml =================================================================== RCS file: /cvs/docs/example-tutorial/example-tutorial-en.xml,v retrieving revision 1.22 retrieving revision 1.23 diff -u -r1.22 -r1.23 --- example-tutorial-en.xml 21 Jan 2006 19:32:04 -0000 1.22 +++ example-tutorial-en.xml 30 Jan 2006 19:11:23 -0000 1.23 @@ -18,7 +18,7 @@ <article id="example-tutorial" lang="en"> -&FDP-INFO; + &FDP-INFO; <section id="sn-some-section"> <title>Some Section</title> @@ -30,7 +30,13 @@ since those tags will make sections less modular, i.e., harder to relocate without changing a lot of other markup. </para> - + <xi:include href="para-en.xml" xmlns:xi="http://www.w3.org/2001/XInclude"> + <xi:fallback> + <para> + Could not find the <filename>para-en.xml</filename> file + </para> + </xi:fallback> + </xi:include> <para> Keep text within the <command>title</command> tags on the same line as the tags. Nesting the title on a separate line from the @@ -51,7 +57,8 @@ avoided. To install any RPM package, use the following syntax: </para> <screen> -<userinput><command>rpm -ivh <replaceable>pkgname</replaceable>-<replaceable>version</replaceable>.<replaceable>arch</replaceable>.rpm</command></userinput> +<userinput><command>rpm -ivh <replaceable>pkgname</replaceable>-<replaceable>version</replaceable>.<replaceable>arch</replaceable>.rpm</command> + </userinput> </screen> <para> Notice that the <command>screen</command> section is entirely @@ -64,7 +71,8 @@ sample. </para> <screen> -<userinput><command>grep snmptrap /etc/services</command></userinput> +<userinput><command>grep snmptrap /etc/services</command> + </userinput> <computeroutput>snmptrap 162/udp snmp-trap # Traps for SNMP</computeroutput> </screen> <para> @@ -157,6 +165,41 @@ </procedure> </section> + <section id="sn-external-files"> + <title>Including External Files</title> + + <para> + An alternative to declaring and using system entities to obtain + the content from other files is to use an + <firstterm>XInclude</firstterm> reference. These work similarly to + include files in familiar programming languages. Using the + XInclude feature allows an entire file, or just a part of it, to + be copied into the current document. External files are referenced + using an <abbrev>URI</abbrev> so they may be located anywhere, + even across the Internet. + </para> + + <para> + The official documentation for the XInclude feature may be found + at the <ulink url="http://www.w3.org/TR/XInclude"/> web site. A + somewhat dated description at + <ulink url="http://www.sagehill.net/docbookxsl/ModularDoc.html"/> + may be a more readible starting reference. + </para> + + <para> + Using the XInclude facility with DocBook requires a special + technique to allow the document to pass XML validation. Often + examples show adding the phrase + <phrase>xmlns:xi="http://www.w3.org/2001/XInclude"</phrase> + to a top-level element such as + <wordasword><chapter></wordasword>. Unfortunately this + causes the DocBook file to fail validation. The solution is to + place the namespace declaration directly in the <xi:include> + element: + </para> + </section> + <index id="generated-index"></index> </article>

1 0

translation-quick-start-guide translation-quick-start-en.xml, 1.8, 1.9 translation-quick-start-it.xml, 1.2, 1.3 rpm-info.xml, 1.5, 1.6
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: pfrields Update of /cvs/docs/translation-quick-start-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv25329 Modified Files: translation-quick-start-en.xml translation-quick-start-it.xml rpm-info.xml Log Message: Fix hostname error Index: translation-quick-start-en.xml =================================================================== RCS file: /cvs/docs/translation-quick-start-guide/translation-quick-start-en.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- translation-quick-start-en.xml 26 Jan 2006 06:27:15 -0000 1.8 +++ translation-quick-start-en.xml 30 Jan 2006 18:37:23 -0000 1.9 @@ -7,8 +7,8 @@ %FEDORA-ENTITIES-EN; <!ENTITY DOCNAME "translation-quick-start-guide"> - <!ENTITY DOCVERSION "0.2"> - <!ENTITY DOCDATE "2006-01-26"> + <!ENTITY DOCVERSION "0.2.1"> + <!ENTITY DOCDATE "2006-01-30"> <!ENTITY DOCID "&DOCNAME;-&DOCVERSION; (&DOCDATE;)"> <!ENTITY FCLOCALVER "4"> @@ -146,7 +146,7 @@ <screen> <command>export CVS_RSH=ssh</command> -<command>export CVSROOT=:ext:<replaceable>username</replaceable>@i18.redhat.com:/usr/local/CVS</command> +<command>export CVSROOT=:ext:<replaceable>username</replaceable>@i18n.redhat.com:/usr/local/CVS</command> <command>cvs -z9 co translate/</command> </screen> Index: translation-quick-start-it.xml =================================================================== RCS file: /cvs/docs/translation-quick-start-guide/translation-quick-start-it.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- translation-quick-start-it.xml 27 Jan 2006 00:50:16 -0000 1.2 +++ translation-quick-start-it.xml 30 Jan 2006 18:37:23 -0000 1.3 @@ -146,7 +146,7 @@ <screen> <command>export CVS_RSH=ssh</command> -<command>export CVSROOT=:ext:<replaceable>username</replaceable>@i18.redhat.com:/usr/local/CVS</command> +<command>export CVSROOT=:ext:<replaceable>username</replaceable>@i18n.redhat.com:/usr/local/CVS</command> <command>cvs -z9 co translate/</command> </screen> Index: rpm-info.xml =================================================================== RCS file: /cvs/docs/translation-quick-start-guide/rpm-info.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- rpm-info.xml 28 Jan 2006 07:09:54 -0000 1.5 +++ rpm-info.xml 30 Jan 2006 18:37:23 -0000 1.6 @@ -30,21 +30,24 @@ Quick start guide to providing translations on the Fedora Project. </desc> </translation> - <translation lang="it"> + <translation lang="it"> <title>Guida rapida alle traduzioni</title> <desc> Guida rapida per fornire traduzioni rapide nel Fedora Project. </desc> </translation> - </titles> <changelog order="newest-first"> + <revision date="2006-01-30" number="0.2.1" role="doc"> + <author worker="PaulWFrields"/> + <details lang="en">Fix hostname error</details> + </revision> <revision date="2006-01-25" number="0.2" role="doc"> <author worker="PaulWFrields"/> <details lang="en">Additional style editing, division of procedures into more readable sections</details> <details lang="it">Ulteriori aggiunte di stile, divisioni delle procedure in sezioni pi�� - leggibili</details> + leggibili</details> </revision> <revision date="Fri Jan 20 2006" number="0.1" role="doc"> <author worker="PaulWFrields"/> @@ -54,7 +57,7 @@ <revision date="Wed Jan 18 2006" number="0.0.1" role="doc"> <author worker="ManuelOspina"/> <details lang="en">First draft</details> - <details lang="en">Prima bozza</details> -</revision> + <details lang="en">Prima bozza</details> + </revision> </changelog> </rpm-info>

1 0

release-notes RELEASE-NOTES-it.xml,1.10,1.11
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: tombo Update of /cvs/docs/release-notes In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv20674/release-notes Modified Files: RELEASE-NOTES-it.xml Log Message: typo fixed. Index: RELEASE-NOTES-it.xml =================================================================== RCS file: /cvs/docs/release-notes/RELEASE-NOTES-it.xml,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- RELEASE-NOTES-it.xml 30 Jan 2006 00:36:05 -0000 1.10 +++ RELEASE-NOTES-it.xml 30 Jan 2006 16:12:37 -0000 1.11 @@ -8,7 +8,7 @@ <!ENTITY ARCH-SPECIFIC-PPC SYSTEM "./ArchSpecificPPC-it.xml"> <!ENTITY ARCH-SPECIFIC-x86 SYSTEM "./ArchSpecificx86-it.xml"> <!ENTITY ARCH-SPECIFIC-x86-64 SYSTEM "./ArchSpecificx86_64-it.xml"> -<!ENTITY BACKWARDS-COMPATIBILITY SYSTEM "./BackwardsCompatbility"> +<!ENTITY BACKWARDS-COMPATIBILITY SYSTEM "./BackwardsCompatibility"> <!ENTITY COLOPHON SYSTEM "./Colophon-it.xml"> <!ENTITY DATABASE-SERVERS SYSTEM "./DatabaseServers-it.xml"> <!ENTITY DESKTOP SYSTEM "./Desktop-it.xml">

1 0

docs-common/w3.org/2001 - New directory
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: jtr Update of /cvs/docs/docs-common/w3.org/2001 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18795/2001 Log Message: Directory /cvs/docs/docs-common/w3.org/2001 added to the repository

1 0

docs-common/w3.org - New directory
by fedora-docs-commits＠redhat.com 30 Jan '06

30 Jan '06

Author: jtr Update of /cvs/docs/docs-common/w3.org In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18774/w3.org Log Message: Directory /cvs/docs/docs-common/w3.org added to the repository

1 0

Jump to page:

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

docs-commits January 2006