Claus chr: Corrected links

2012-09-09T10:24:36Z

Corrected links

Claus chr at 08:28, 2 September 2012

2012-09-02T08:28:38Z

Claus chr at 09:06, 1 September 2012

2012-09-01T09:06:07Z

Claus chr: 1 revision: Moving Docbook Primer from UserBase to TechBase

2012-09-01T08:47:32Z

1 revision: Moving Docbook Primer from UserBase to TechBase

Annew: Marked this version for translation

2011-11-30T14:30:45Z

Marked this version for translation

New page

<translate>

=== <tt>book</tt> and the <tt>bookinfo</tt> section === 


The <tt>bookinfo</tt> section is most easily prepared by copying the KDE template.


{{Tag|1=book lang="&language"}}
</translate><translate>


:Contains the entire document. Most important thing to remember is the <tt>lang</tt> attribute, which must contain exactly <tt>&language;</tt>, and must not be changed. To set the language for the document, change the entity as described in the [[#prologue|prologue]] section.


{{Tag|bookinfo}}
</translate><translate>


:Wraps the "meta" information – information about the document, not about the application it is documenting. Required in KDE documentation. No attributes.


{{Tag|authorgroup}}
</translate><translate>


:Wraps the author information, and may also contain {{Tag|othercredit}} information. Required in KDE documentation. No attributes.


{{Tag|author}}
</translate><translate>


:Required element in the header section of all KDE documentation. Use this element ''only'' for the author(s) of the document. Other contributers (developers, translators, and so on) should be credited in the [[#othercredit|{{Tag|othercredit}}]] section. No attributes.


{{Tag|personname}}
</translate><translate>


:Used to wrap a person's name. You can use this directly in the text as well, but here it should be used to contain each author or contributor name.


{{Tag|firstname}}
</translate><translate>


:The contributor's first name.


{{Tag|othername}}
</translate><translate>


:If the author normally uses more than a first and surname, you can add further names here.


{{Tag|surname}}
</translate><translate>


:The author's surname.


{{Tag|email}}


:An email address for the maintainer of the document is required for KDE documentation. You do not have to use your primary private address, and you may be able to arrange for someone else (the developer perhaps) to receive the email regarding the document. In any case, there must be an address for users and translators to contact regarding errors and document bugs.


{{Note|1=In previous versions of DocBook, {{Tag|email}} could not be used directly inside {{Tag|author}}. Since DocBook XML V 4.2 (used by KDE for documents after KDE 3.1.x), this is possible, which simplifies this markup considerably.}}


:In other contexts in the document, {{Tag|email}} is used to contain any email address, and is not used inside the <tt>address</tt> element.


{{Tag|1=othercredit role=""}}
</translate><translate>


:Similary to <tt>author</tt>, this is a wrapper around information describing other contributors to the document. Include here the contributor's name and email address as you do for the author. See the template for more details.


:The <tt>role</tt> attribute is required, and can contain any one of the following:


*Translator
*Developer
*Reviewer
*Graphist
*Musician


:The <tt>othercredit</tt> element also includes the <tt>contrib</tt> element.


:{{Tag|contrib}}
</translate><translate>


::The role this contributor played in the document or application preparation. This could contain something like:
:* Developer
:* ''Deutsche Übersetzung
:* Reviewer
:* ''Traduction française


{{Tag|corpauthor}}
</translate><translate>


:This is used in very specific circumstances, where an organization (e.g. "The KDE Team") is being credited with authorship of a document. Authors writing about applications should not use this and should credit themselves. If you do find a need to use this, please be sure to include a maintainer's name and email address in the credits chapter of the document.


{{Tag|copyright}}
</translate><translate>


:This is a wrapper for copyright information. <tt>copyright</tt> must contain these elements:


:{{Tag|year}}
</translate><translate>


::Add one <tt>year</tt> element for each year in which the document was changed or added to. Don't put more than one year in each tag, rather add more <tt>year</tt> elements, and use the 4 digit "YYYY" format.


:{{Tag|holder}}
</translate><translate>


::The usual full name of the copyright holder(s). If there is more than one copyright holder (the document was previously maintained by another person, or is written collaboratively), then add more <tt>copyright</tt> sections, rather than trying to fit multiple names in the one section.


:Copyright is automatically held by the author of the document, but the <tt>copyright</tt> element is still required for all KDE documentation. None of the elements contained have any attributes.


::Please do ''not'' add more names or years to existing {{Tag|holder}} or {{Tag|year}} elements. Add more, if they are required, or have multiple <tt>copyright</tt> sections.


{{Tag|legalnotice}}
</translate><translate>


:This contains, of course, a legal notice. This is absolutely required for any KDE document. In the context of this section, it should contain the <tt>&FDLNotice;</tt> entity, which inserts some information into the document about the document's license (and ''not'' the license of the application you are describing.)


{{Tag|date}}
</translate><translate>


:''The date is very important.'' It is used not only by scripts for automatic processing of documentation, but is also central to revision control and co-ordination of translations. You must change the date if you have changed the ''original'' document, and you must ''not'' change the date if you are a translator. The format of the date is very important. It ''must'' be in the ISO, with "literal" delimiters, in the form "yyyy-mm-dd". Please be extremely careful about this, and triple check it before you send in the document.


{{Tag|releaseinfo}}
</translate><translate>


:This should match exactly the version of the ''application'' you are documenting. It should normally conform to the format X.x.xx (where X is a major version number and x are minor version numbers, however, you no longer have to pad the content to this length. That is to say, if the application has released version "1.4", you may write <tt><releaseinfo>1.4</releaseinfo></tt>, and you do not need to make it <tt><releaseinfo>1.04.00</releaseinfo></tt>


:This is ''not'' the version of the document. There are no attributes, and this element is required in KDE documentation.


{{Tag|abstract}}
</translate><translate>


:In KDE Documentation, the abstract is required. It should be a short one- or two-sentence summary of the document. The abstract is not the place to put version or contact information, but it should say something about the application and its purpose. For example "KFoo is a small fast network enabled foo generator, suitable for both beginner and advanced foo users.".


:The abstract is your chance to sum up the application in a small paragraph — in '''KHelpCenter''' it shows up on the first page as your document is selected, and the abstract frequently shows up in the summary of your document in web searches. A short overview of the application you are writing about is very valuable in this situation, "This is the KFoo handbook and describes KFoo 1.2." on its own, is not.


{{Tag|keywordset}}
</translate><translate>


:A wrapper for a set of keywords suitable for search engines. Required for KDE Documentation, and there are no attributes. The <tt>keywordset</tt> should contain several {{Tag|keyword}}s.


{{Tag|keyword}}
</translate><translate>


:Add one {{Tag|keyword}} inside the {{Tag|keywordset}} for each search term. You must include at a minimum the terms "KDE", the name of the application you are documenting, and the name of the package it is found in, for example "kdegames". The keywords should be in order from most general first (that is, KDE) through less general, to the most specific. Add two or three more relevant words that people might search with, e.g., for the application '''KWrite''' you might add "editor" and "text". This is required for KDE Documentation, and there are no attributes.


<tt></tt>
</translate><translate>


:This line is specific to KDE documentation. Although it's a comment, it is ''absolutely'' required in documents. It is used by the translation system as a placeholder for the translation teams to add their own role info. Translators should add more <tt>othercredit</tt> sections here as appropriate.


:'''Example: The bookinfo section from the KDE template'''
{{Input|1=<nowiki>
<bookinfo>
<title>The &kmyapplication; Handbook</title>


<authorgroup>
<author>

<personname>
<firstname>George</firstname>
<othername>N.</othername>
<surname>Ugnacious</surname>
</personname>
<email>gnu@kde.org</email>
</author>
</authorgroup>





<copyright>
<year>2002</year>
<holder>George N. Ugnacious</holder>
</copyright>


<legalnotice>&FDLNotice;</legalnotice>





<date>2003-01-10</date>
<releaseinfo>1.1.</releaseinfo>





<abstract>
<para>
&kmyapplication; is an application specially designed to do nothing you would
ever want.
</para>
</abstract>





<keywordset>
<keyword>KDE</keyword>
<keyword>kdeutils</keyword>
<keyword>Kapp</keyword>
<keyword>nothing</keyword>
<keyword>nothing else</keyword>
</keywordset>


</bookinfo>
</nowiki>}}


{{Prevnext2
| prevpage=Documentation Primer/Manual/DocBook Reference/Prologue
| prevtext=The Prologue
| nextpage=Documentation Primer/Manual/DocBook Reference/Chapters and Sections
| nexttext=Chapters and Sections
| index=Documentation Primer/Manual
| indextext=Back to Menu
}}

</translate>

← Older revision		Revision as of 08:28, 2 September 2012
Line 1:		Line 1:
	<languages />		<languages />
−	~~{{Transferring}}~~
	<translate>		<translate>

← Older revision		Revision as of 09:06, 1 September 2012
Line 1:		Line 1:
		+	<languages />
		+	{{Transferring}}
	<translate>		<translate>

@@ Line 12: / Line 12: @@
 <!--T:4-->
-:Contains the entire document. Most important thing to remember is the <tt>lang</tt> attribute, which must contain exactly <tt>&amp;language;</tt>, and must not be changed. To set the language for the document, change the entity as described in the [[#prologue|prologue]] section.
+:Contains the entire document. Most important thing to remember is the <tt>lang</tt> attribute, which must contain exactly <tt>&amp;language;</tt>, and must not be changed. To set the language for the document, change the entity as described in the [[Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Prologue|prologue]] section.
 <!--T:5-->
@@ Line 33: / Line 33: @@
 <!--T:10-->
-:Required element in the header section of all KDE documentation. Use this element ''only'' for the author(s) of the document.  Other contributers (developers, translators, and so on) should be credited in the [[#othercredit|{{Tag|othercredit}}]] section.  No attributes.
+:Required element in the header section of all KDE documentation. Use this element ''only'' for the author(s) of the document.  Other contributers (developers, translators, and so on) should be credited in the [[Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Book and Bookinfo#othercredit|{{Tag|othercredit}}]] section.  No attributes.
 <!--T:11-->
@@ Line 275: / Line 275: @@
 <!--T:67-->
 {{Prevnext2
-| prevpage=Documentation Primer/Manual/DocBook Reference/Prologue
+| prevpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Prologue
 | prevtext=The Prologue
-| nextpage=Documentation Primer/Manual/DocBook Reference/Chapters and Sections
+| nextpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/Chapters and Sections
 | nexttext=Chapters and Sections
-| index=Documentation Primer/Manual
+| index=Special:myLanguage/Documentation Primer/Manual
 | indextext=Back to Menu
 }}
 </translate>

Documentation Primer/Manual/DocBook Reference/Book and Bookinfo - Revision history

Claus chr: Corrected links

Claus chr at 08:28, 2 September 2012

Claus chr at 09:06, 1 September 2012

Claus chr: 1 revision: Moving Docbook Primer from UserBase to TechBase

Annew: Marked this version for translation