Claus chr: Corrected links

2012-09-09T10:34:36Z

Corrected links

Claus chr at 08:30, 2 September 2012

2012-09-02T08:30:42Z

Claus chr at 09:08, 1 September 2012

2012-09-01T09:08:08Z

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

2012-09-01T08:47:33Z

1 revision: Moving Docbook Primer from UserBase to TechBase

Annew: Marked this version for translation

2011-11-30T15:46:14Z

Marked this version for translation

New page

<translate>

=== Images and Examples === 


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


:Wrapper around screenshots. Use this when you are including a screenshot in your document.


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


:Screeninfo is a description of the screenshot. It's common (but not required) to reuse this text in the textobject element, as it saves translation time.


{{Tag|mediaobject}} and {{Tag|inlinemediaobject}}
</translate><translate>
</translate><translate>


:Use {{Tag|inlinemediaobject}} to insert an inline image (that is, one that is inside a paragraph of text, or is the only item in a table entry. Use {{Tag|mediaobject}} for all other images. If the image is a screenshot, the {{Tag|mediaobject}} should be wrapped with a {{Tag|screenshot}} element. mediaobjects contain the following items:


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


:Imageobject contains information about one specific image. DocBook allows you to add more than one imageobject, in order to provide alternatives if the user is unable to see the preferred image. We don't currently use this functionality in KDE Documentation, but may do at some time in the future.


{{Tag|1=imagedata fileref="" format=""}}
</translate><translate>


:This element holds the actual image reference. The fileref indicates the location of the image. You should always keep images in the same folder as the document itself, so you need only put the filename into the fileref attribute. The format indicates the type of image you are including. For KDE this should be PNG. Do ''not'' use gif format images for KDE documents.


:This is one of few "empty" elements in use in KDE Documentation. This means there is no {{Tag|/imagedata}}, but you should ''always'' close the element as shown above, with a final "/".


:Keep the images in the same folder as your <tt>index.docbook</tt>, don't create a separate folder to store them in.


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


:Encloses the text part of a screenshot, which for KDE Documentation means it contains a {{Tag|phrase}} element.


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


:A short descriptive phrase about the image contents, this element is contained in the {{Tag|textobject}} element.


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


:If you want the image to have a caption when displayed, you can add this. It's not required for KDE documents, but recommended, especially if there are several images near each other and there could be confusion as to which you are referring in the text.


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


:Use this element to enclose any informal examples you use in your document. There are no attributes. An informal example can contain almost any markup, so feel free to use them liberally. They should generally not be part of a paragraph.


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


:An example is a more formal example, which has a title and an entry in the table of contents. Use sparingly, because having a hundred examples listed in the contents of a 5 page document lessens their usefulness. However, don't hesitate to use when you think it's necessary.


:I've used them in this document to make it easy to quickly go to the small "template" examples for complex markup, because you can find them directly from the table of contents. Less difficult examples in this document have {{Tag|informalexample}} instead. Use your best judgement. As with {{Tag|informalexample}}, they can contain almost any markup.


'''Example: A screenshot example'''


{{Input|1=<nowiki>
<screenshot>
<screeninfo>An example image</screeninfo>
<mediaobject>
<imageobject>
<imagedata fileref="example.png" format="PNG" />
</imageobject>
<textobject>
<phrase>An example image</phrase>
</textobject>
</mediaobject>
</screenshot>
</nowiki>}}


{{Prevnext2
| prevpage=Documentation Primer/Manual/DocBook Reference/FAQ
| prevtext=Questions and Answers
| nextpage=Documentation Primer/Manual/DocBook Reference/General markup
| nexttext=General markup
| index=Documentation Primer/Manual
| indextext=Back to Menu
}}

</translate>

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

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

@@ Line 105: / Line 105: @@
 <!--T:27-->
 {{Prevnext2
-| prevpage=Documentation Primer/Manual/DocBook Reference/FAQ
+| prevpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/FAQ
 | prevtext=Questions and Answers
-| nextpage=Documentation Primer/Manual/DocBook Reference/General markup
+| nextpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/General markup
 | nexttext=General markup
-| index=Documentation Primer/Manual
+| index=Special:myLanguage/Documentation Primer/Manual
 | indextext=Back to Menu
 }}
 </translate>

Documentation Primer/Manual/DocBook Reference/Images and Examples - Revision history

Claus chr: Corrected links

Claus chr at 08:30, 2 September 2012

Claus chr at 09:08, 1 September 2012

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

Annew: Marked this version for translation