Claus chr: Corrected links

2012-09-09T10:33:22Z

Corrected links

Claus chr at 08:30, 2 September 2012

2012-09-02T08:30:15Z

Claus chr at 09:07, 1 September 2012

2012-09-01T09:07:34Z

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-30T15:44:44Z

Marked this version for translation

New page

<translate>

=== Describing actions and commands === 


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


:Use this for placeholder or sample text, that a user would not actually type, but would instead replace with the correct text for their environment. For example, <tt>Edit the file <filename><replaceable>/usr/local/foo/bar</replaceable></filename></tt>, because it may already be established that <tt>/usr/local</tt> is only the default location of this file, and the user may have it installed to e.g. <tt>/opt/</tt> instead.


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


:Use this to mark up the name of any software program mentioned in the text. Don't use this to mark up the actual command issued to execute the application. For example, {{TagPair|application|Kate}} is the name of the editor, but {{TagPair|command|kate}} is the name of the command that starts the '''Kate''' application.


{{Note|1=All KDE applications, and several non-KDE but very common applications, are provided as entities.}}


:For the KDE applications, using the entities will save you much typing, and will ensure that applications are always referred to with their correct name across all documentation. The entity is always the application's executable name, in lower case, e.g. <tt>&kcontrol;</tt>, <tt>&konqueror;</tt> or <tt>&kmail;</tt>.


:For non-KDE applications, one of the major reasons to use the entities is that there are legal implications, so far as we are required to acknowledge trademarks and copyrights held by others outside our organisation. You will find in (TODO: write this section!)a list containing a list of the more common non-KDE application entities.


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


:Catch all element for gui interface items that do not have a more specific tag. You can use this to markup things like the "View pane" in <tt>&khelpcenter;</tt>, or the "Board" in <tt>&kjumpingcube;</tt>.


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


:''Any'' text that the user must type, including commands and data entry.


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


:Used to represent the computer screen (usually to represent a terminal or console.) Text contained in {{Tag|screen}} is considered to be literal text — line breaks and white space are honored and it will be rendered with a mono-spaced font. Don't use screen when what you really want is an example, or an informal example.


{{Tag|command}}


:Text the user enters to instruct the computer or an application to do something. <code>ls -al</code> is a command (it's also userinput, and has options.) <code>/join #kde</code> in an irc client is a command (and again, is userinput.)


:Commands are not <tt>userinput</tt> when you are not expecting the user to actually type them, for example in the sentence "The output from the <code>ls</code> command should show you...", the text "ls" is a command, but is not <tt>userinput</tt> in this context.


:Applications not marked up with the {{Tag|application}} tag are also considered commands, for example, <code>gcc</code>, <code>automake</code> and <code>autoconf</code>.


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


:The prompt at which a user types input. For most KDE Documentation, this has been standardised as {{Tag|prompt}}{{Entity|percnt}}{{Tag|/prompt}} (which is the % character).


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


:An optional parameter to a command. Since we write about UNIX® platforms, an option on the commandline is almost always indicated by a "-", but there are exceptions (e.g., <code>tar zxvf '''filename.tar.gz'''</code> or <code>ps ax</code>, which are marked up as {{Tag|userinput}}{{TagPair|command|tar}} {{TagPair|option|zxvf}} {{TagPair|replaceable|filename.tar.gz}}{{Tag|/userinput}} and {{Tag|userinput}}{{TagPair|command|ps}} {{TagPair|option|ax}}{{Tag|/userinput}} respectively.


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


:An environment variable. Note that the variable indicator (usually $ for UNIX®) is not part of the name of the environment variable, so it is correct to do this: <tt>$</tt>{{TagPair|envar|KDEDIR}}. There are no attributes in use in KDE Documentation.


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


:A (usually numeric, but not always) error code. <tt>SIGSEGV</tt> is an errorcode, as is <tt>404</tt> as you might receive when you are web browsing.


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


:The actual text of an error message - to reuse the <tt>404</tt> example, the {{Tag|errorname}} might be <tt>Page not found</tt>.


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


The type of error, e.g. <tt>fatal</tt> or <tt>recoverable</tt>.


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


:Use {{Tag|filename}} for all occurrences of file names including:


* Folder names — with the attribute <tt>class="directory"</tt>


* Paths


* File names


* File name placeholders (which should also be tagged with {{Tag|replaceable}}


:Do not use {{Tag|filename}} for file fragments or extensions (i.e. <tt>*.tgz</tt> which should instead be marked up as [[Documentation Primer/Manual/DocBook Reference/General markup#literal|{{Tag|1=literal role="extension"}}]].


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


:Symbols are things that are replaced by the computer when they are processed. It's difficult to say when things are a symbol and when they are not - if there is a more specific element to use (e.g. {{Tag|envar}} or {{Tag|constant}} then you should use that instead.


{{Prevnext2
| prevpage=Documentation Primer/Manual/DocBook Reference/GUI elements
| prevtext=The GUI elements, menus, toolbars and shortcuts
| nextpage=Documentation Primer/Manual/DocBook Reference/FAQ
| nexttext=Questions and Answers
| 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:07, 1 September 2012
Line 1:		Line 1:
		+	<languages />
		+	{{Transferring}}
	<translate>		<translate>

@@ Line 122: / Line 122: @@
 <!--T:37-->
-:Do not use {{Tag|filename}} for file fragments or extensions (i.e. <tt>*.tgz</tt> which should instead be marked up as [[Documentation Primer/Manual/DocBook Reference/General markup#literal|{{Tag|1=literal role="extension"}}]].
+:Do not use {{Tag|filename}} for file fragments or extensions (i.e. <tt>*.tgz</tt> which should instead be marked up as [[Special:myLanguage/Documentation Primer/Manual/DocBook Reference/General markup#literal|{{Tag|1=literal role="extension"}}]].
 <!--T:38-->
@@ Line 133: / Line 133: @@
 <!--T:40-->
 {{Prevnext2
-| prevpage=Documentation Primer/Manual/DocBook Reference/GUI elements
+| prevpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/GUI elements
 | prevtext=The GUI elements, menus, toolbars and shortcuts
-| nextpage=Documentation Primer/Manual/DocBook Reference/FAQ
+| nextpage=Special:myLanguage/Documentation Primer/Manual/DocBook Reference/FAQ
 | nexttext=Questions and Answers
-| index=Documentation Primer/Manual
+| index=Special:myLanguage/Documentation Primer/Manual
 | indextext=Back to Menu
 }}
 </translate>

Documentation Primer/Manual/DocBook Reference/Actions and Commands - Revision history

Claus chr: Corrected links

Claus chr at 08:30, 2 September 2012

Claus chr at 09:07, 1 September 2012

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

Annew: Marked this version for translation