Tasks and Tools: Difference between revisions

From KDE Wiki Sandbox
(Added anchor point for subpage linking)
(improve info on preferences)
 
(17 intermediate revisions by 5 users not shown)
Line 10: Line 10:


<!--T:26-->
<!--T:26-->
* Be aware that your contribution will be governed by the [[KDE_UserBase_Wiki:Copyrights|twin licenses]] for which icon-links are provided in the side-bar of each page.  Click on the images in the Navigation Panel to read the details.  You are agreeing to your contribution being publicly available and that others can use that information on their own sites.
* Be aware that your contribution will be governed by the [[KDE_UserBase_Wiki:Copyrights|twin licenses]] for which icon-links are provided in the side-bar of each page.  Click on the images in the Navigation Panel to read the details.  You are agreeing to your contribution being publicly available and that others can use that information on their own sites.
 
<!--T:29-->
[[File:Userbase twin licenses.png|center|the twin licenses]]


<!--T:27-->
<!--T:27-->
Line 27: Line 30:


== Ways to Contribute == <!--T:7-->
== Ways to Contribute == <!--T:7-->
</translate><span id="Update Existing Content"></span><translate>


=== Update Existing Content === <!--T:8-->
=== Update Existing Content === <!--T:8-->
Line 34: Line 39:
* [[Special:myLanguage/Taking Screenshots|Create a screenshot]]
* [[Special:myLanguage/Taking Screenshots|Create a screenshot]]
* [[Special:myLanguage/Modify a Page|Modify existing content]], fix a spelling, clarify a description, add more details.
* [[Special:myLanguage/Modify a Page|Modify existing content]], fix a spelling, clarify a description, add more details.
</translate><span id="Add New Pages"></span><translate>


=== Add New Pages === <!--T:10-->
=== Add New Pages === <!--T:10-->
Line 47: Line 54:
<!--T:13-->
<!--T:13-->
* [[Special:myLanguage/Edit Markup|Preparing a page for translation]] needs more patience than skill.  If you can spare short periods of time, frequently, this is a very helpful task.
* [[Special:myLanguage/Edit Markup|Preparing a page for translation]] needs more patience than skill.  If you can spare short periods of time, frequently, this is a very helpful task.
* [[Special:myLanguage/Translate a Page|Translate a page]].  You need to be fluent in a language, but not a professional translator to translate a wiki page.  Translating manuals is the skill of a special team.
* [[Special:myLanguage/Translate a Page|Translate a page]].  You need to be fluent in a language, but not a professional translator to translate a wiki page.  Translating manuals is the skill of a special team.  That page also points you to instructions for translating sidebar links.
* [[Special:myLanguage/Off-line_Translation|Translate with Off-Line Tools]].  Get the essentials for Gettext and Import.
* [[Special:myLanguage/Off-line_Translation|Translate with Off-Line Tools]].  Get the essentials for Gettext and Import.
* [[Special:myLanguage/How_To_Convert_a_UserBase_Manual_to_Docbook|How To Convert UserBase Manual to Docbook]] gives you an insight into the process that takes place on your finished manual.
* [[Special:myLanguage/How_To_Convert_a_UserBase_Manual_to_Docbook|How To Convert UserBase Manual to Docbook]] gives you an insight into the process that takes place on your finished manual.
* [http://kde-apps.org/content/show.php/KDE+WikiSentinel?content=158697 WikiSentinel] is a specialized feed reader that collects the translated pages that need to be updated. It allows you to see a preview of the changes in the selected page and open it directly in the web browser: ready to translate.


<!--T:14-->
<!--T:14-->
Line 58: Line 66:


<!--T:21-->
<!--T:21-->
* Make sure you refer frequently to this page, to [[Special:myLanguage/Tasks_and_Tools|Tasks and Tools]] and to [[Special:myLanguage/Typographical_Guidelines|Typographical Guidelines]]
* Make sure you refer frequently to this page and to [[Special:myLanguage/Typographical_Guidelines|Typographical Guidelines]]


<!--T:22-->
<!--T:22-->
Line 64: Line 72:


<!--T:23-->
<!--T:23-->
* Make application name formatting consistent (avoid using '''Amarok'''s, do use '''Amarok's''').
* Make application name formatting consistent (avoid using '''Amarok''''s, do use '''Amarok's''').


<!--T:24-->
<!--T:24-->
Line 73: Line 81:


==Hints and Tips== <!--T:16-->
==Hints and Tips== <!--T:16-->
<!--T:28-->
{{Attention|1=If a page is completely superceeded and should be deleted, please list it on [[Pages_for_Deletion|Pages for Deletion]] where an Admin will deal with it.}}


<!--T:17-->
<!--T:17-->
Line 78: Line 89:


<!--T:18-->
<!--T:18-->
* If you don't have [edit] links against the sections, open your <menuchoice> My Preferences</menuchoice> (in the <menuchoice>Personal Tools </menuchoice>section of the sidebar) then look for <menuchoice>Editing</menuchoice> and in the <menuchoice>Advanced Options</menuchoice> set <menuchoice>Enable section editing via [edit] links</menuchoice>
* At the top of the page you will find the <menuchoice>Preferences</menuchoice> menu. In the <menuchoice>Editing</menuchoice> section you may want to enable <menuchoice>Show preview on first edit</menuchoice> - while you are editing you can glance at the original display for reference
* While you are in those settings, enable <menuchoice>Show preview on first edit</menuchoice> - while you are editing you can glance at the original display for reference
* The default display is to show the preview first, with the edit box below.  If you prefer the edit box at the top you can change that setting in the same place
* The default display is to show the preview first, with the edit box below.  If you prefer the edit box at the top you can change that setting in the same place


<!--T:19-->
<!--T:19-->
[[Category:Contributing]]
[[Category:Contributing]]
</translate>
</translate>

Latest revision as of 19:23, 3 November 2020

Before you Start

First Things First

  • To contribute to UserBase you must register an account. See what advantages this brings you on the Quick Start page. There you will also find help to register and log in.
  • Be aware that your contribution will be governed by the twin licenses for which icon-links are provided in the side-bar of each page. Click on the images in the Navigation Panel to read the details. You are agreeing to your contribution being publicly available and that others can use that information on their own sites.
the twin licenses
the twin licenses
  • Use the Talk page to communicate with other contributors or get help. Normally someone will get back to you within a day.

Relevance

It should relate to KDE software, directly or indirectly. We define it like this:

For New Users - helping to get started
For Regular Users - learning about new features and tips
For Advanced Users - but use sub-pages for this.
File:Edit-delete.png Not for Developers - Techbase is the place for that

Ways to Contribute

Update Existing Content

Add New Pages

  • Create a new page, showcase an application, introduce a new concept.
  • Write a manual. You need to know an application quite well, and probably to be in contact with the author. We can help you.

Working with Languages

  • Preparing a page for translation needs more patience than skill. If you can spare short periods of time, frequently, this is a very helpful task.
  • Translate a page. You need to be fluent in a language, but not a professional translator to translate a wiki page. Translating manuals is the skill of a special team. That page also points you to instructions for translating sidebar links.
  • Translate with Off-Line Tools. Get the essentials for Gettext and Import.
  • How To Convert UserBase Manual to Docbook gives you an insight into the process that takes place on your finished manual.
  • WikiSentinel is a specialized feed reader that collects the translated pages that need to be updated. It allows you to see a preview of the changes in the selected page and open it directly in the web browser: ready to translate.
Remember
It's important to be consistent, particularly in Manuals, so here are some general rules:
  • Take care with heading levels - we start at second level (Mediawiki uses top level for page-name), using ==
  • Make application name formatting consistent (avoid using Amarok's, do use Amarok's).
  • Ensure that all images are in PNG format (you can use JPEG as well, but in this case you should convert your images to PNG later). Save work by converting them before you start .
  • Remove all non-printable characters from image names.


Hints and Tips

Attention
If a page is completely superceeded and should be deleted, please list it on Pages for Deletion where an Admin will deal with it.


Some Preferences that will help -

  • At the top of the page you will find the Preferences menu. In the Editing section you may want to enable Show preview on first edit - while you are editing you can glance at the original display for reference
  • The default display is to show the preview first, with the edit box below. If you prefer the edit box at the top you can change that setting in the same place