Difference between revisions of "Documentation/Dashboard/Wiki Editing Policy"

From Apache OpenOffice Wiki
Jump to: navigation, search
(Adding a new Documentation Template)
(List of Existing Documentation Templates)
(150 intermediate revisions by 17 users not shown)
Line 1: Line 1:
{{Documentation/Banner}}
+
[[ru:RU/wiki_editing_policy|Политика Wiki-редактирования]]
{{Documentation/DraftPage}}
+
[[fr:FR/Documentation/Dashboard/Wiki_Editing_Policy]]
 +
[[oc:OC/Documentation/TableuBord/Organizacion|Estructura del Wiki Documentacion]]
 +
[[es:ES/AyudaWiki/Plantillas]]
 +
{{DocBanner}}
  
This article helps you to contribute effectively to the Documentation part of the wiki. We strongly encourage you to announce new pages or major changes to the mailing list [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org].
+
{{DISPLAYTITLE:Wiki Editing Policy}}
  
 +
This article helps you to contribute effectively to the Documentation part of the wiki. We strongly encourage you to announce new pages or major changes to the mailing list [mailto:doc@openoffice.apache.org doc@openoffice.apache.org].
  
=Prerequisites for Editing=
 
  
 +
= Project-independent ruleset =
 +
{{Note|See the general project-independent rules at [[OOo_Wiki_Contribution_Rules]] first!}}
 +
 +
= Prerequisites for Editing =
 
You must be registered and logged in before you can edit the Wiki. Registration is easily done.  
 
You must be registered and logged in before you can edit the Wiki. Registration is easily done.  
# Click on '''Log in / create account''' in the upper right corner of the screen and enter the required bits. <br> We recommend using the same username as on the OpenOffice.org website.  
+
# Click on '''Log in / create account''' in the upper right corner of the screen and enter the required bits.  
 
# Subsequently you have to validate your email address.
 
# Subsequently you have to validate your email address.
  
 
For further logins you use the same entry point, enter Username and Password, and click the '''Log in''' button.
 
For further logins you use the same entry point, enter Username and Password, and click the '''Log in''' button.
  
Next step could be to tell the Community about yourself. There is definitely no harm and it is a good way of getting comfortable with the Wiki.
+
{{Warn | To combat vandalism, newly registered users cannot edit any page or create a new page until a '''four (4) day "cooling off period"''' has elapsed.}}
#In the toolbox on the left side click '''Special pages'''.
+
The next step could be to tell the Community about yourself. There is definitely no harm and it is a good way of getting comfortable with the Wiki.
#Click '''User list''' in the Special pages link list.
+
#When you are logged in, your username shows at the top of the page, <span style="color:#9F0000"> in red,</span> until you create your user page. Click on your username to do that.
#Search for your User name and then click on it.
+
 
#On your page, add some sections as given below, as it is your profile on the OpenOffice Wiki;
 
#On your page, add some sections as given below, as it is your profile on the OpenOffice Wiki;
 
#* About yourself
 
#* About yourself
Line 26: Line 32:
 
#* Contact  
 
#* Contact  
  
So, this is somewhat a template, for creating a profile.
+
So, this is somewhat of a template, for creating a profile.
You may or may not need to follow this template, you may have sections of your choice. This is done to make a profile in a uniform way for all the new users.
+
You may or may not need to follow this template, you may have sections of your choice. This is done to make a uniform profile for all the new users.
 
+
  
 
=Adding Comments=
 
=Adding Comments=
  
Important comments should be announced on the mailing list [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org] to be sure that they get noticed.
+
Important comments should be announced on the mailing list [mailto:doc@openoffice.apache.org doc@openoffice.apache.org] to be sure that they get noticed.
  
 
To add a comment to a page
 
To add a comment to a page
Line 38: Line 43:
 
#* If you are starting a new topic click on the '''+''' sign to the right of the '''edit''' tab at the top, fill in the subject line and write your comment in the main text box.
 
#* If you are starting a new topic click on the '''+''' sign to the right of the '''edit''' tab at the top, fill in the subject line and write your comment in the main text box.
 
#* If you want to add a comment to an existing discussion leave it after the existing comments and indent it by putting one or more colons (<code>:</code>) at the beginning of each paragraph.
 
#* If you want to add a comment to an existing discussion leave it after the existing comments and indent it by putting one or more colons (<code>:</code>) at the beginning of each paragraph.
# Sign your username with four tildes (<code><nowiki>~~~~</nowiki></code>). You can do this automatically with the '''signature with timestamp''' button on the toolbar.
+
# Sign your username with four tildes (<code><nowiki>~~~~</nowiki></code>). You can do this automatically with the '''signature with timestamp''' button ( http://wiki.services.openoffice.org/w/skins/common/images/button_sig.png ) on the toolbar.
 
# Click '''Save Page'''.
 
# Click '''Save Page'''.
  
Line 54: Line 59:
  
 
The current wiki page tree looks like this:
 
The current wiki page tree looks like this:
 
wiki.services.openoffice.org/wiki/Documentation
 
    |
 
    +---Dashboard
 
    +---Administration Guide
 
    +---FAQ
 
    +---How Tos
 
    +---OOoAuthors User Manual
 
    +---Tutorials
 
    +---Samples, Templates and Clipart
 
    +---Setup Guide
 
    +---BASIC Guide
 
 
 
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 
|-
 
|-
 
!Subpage!!Description
 
!Subpage!!Description
 
|-
 
|-
|Documentation/Dashboard
+
|[[Documentation/Dashboard]]
 
|High-level tracking of documentation sub-projects and content deliverables
 
|High-level tracking of documentation sub-projects and content deliverables
 
|-
 
|-
|Documentation/Administration Guide
+
|[[Documentation/Administration Guide]]
 
|Guide that describes how to administer an OpenOffice.org network installation
 
|Guide that describes how to administer an OpenOffice.org network installation
 
|-
 
|-
|Documentation/FAQ
+
|[[Documentation/FAQ]]
 
|Collection of FAQs.
 
|Collection of FAQs.
 
|-
 
|-
|Documentation/How Tos
+
|[[Documentation/How Tos]]
 
|Link collection of How Tos
 
|Link collection of How Tos
 
|-
 
|-
|Documentation/OOoAuthors User Manual
+
|[[Documentation/OOoAuthors User Manual]]
|Collection of User Guides from OOoAuthors
+
|Collection of OpenOffice.org 2.x User Guides from OOoAuthors
 
|-
 
|-
|Documentation/Tutorials
+
|[[Documentation/OOo3 User Guides]]
 +
|Collection of OpenOffice.org 3 User Guides from OOoAuthors
 +
|-
 +
|[[Documentation/Tutorials]]
 
|Tutorial collections from different contributors
 
|Tutorial collections from different contributors
 
|-
 
|-
|Documentation/Samples, Templates and Clipart
+
|[[Documentation/Samples, Templates and Clipart]]
 
|Sub-project page in order to provide usable templates for business and personal use (draft)
 
|Sub-project page in order to provide usable templates for business and personal use (draft)
 
|-
 
|-
|Documentation/Setup Guide
+
|[[Documentation/Setup Guide]]
|Sub-project page in order to provide a guide through the setup process of OpenOffice.org (draft)
+
|Sub-project page in order to provide a guide through the setup process of OpenOffice.org (in progress)
 
|-
 
|-
|Documentation/BASIC Guide
+
|[[Documentation/BASIC Guide]]
|Guide that provides an introduction to programming with OpenOffice.org Basic
+
|Guide that provides an introduction to programming with OpenOffice.org BASIC
 +
|-
 +
|[[Documentation/Building Guide]]
 +
|Guide that describes how to build the {{OOo}} software yourself, from source.
 +
|-
 +
|[[Documentation/DevGuide]]
 +
|Guide that describes how to program with OpenOffice.org using the component technology UNO (Universal Network Objects) with OpenOffice.org.
 +
|-
 +
|[[Documentation/Reference]]
 +
|Collection of reference material. References on this page should show up under '''Reference Lists''' at the Documentation main page.
 
|}
 
|}
 
  
 
=Creating new Pages=
 
=Creating new Pages=
  
{{Documentation/Caution | Before creating a page make sure that there is not already an existing page with a similar topic.}}
+
{{Warn | Before creating a page make sure that there is not already an existing page with a similar topic.}}
  
 
* If the new page can be a subpage of an existing page simply go to the existing page and create a link to the new page. After saving the page with the link you can click the link and start writing on your new page.
 
* If the new page can be a subpage of an existing page simply go to the existing page and create a link to the new page. After saving the page with the link you can click the link and start writing on your new page.
  
* If you want to create a really new page for the Documentation project, you can use the wiki's URL for creating a new page. You should observe the wiki page tree when you create a new page in this way. The URL to a wiki page is then something like this: <br>  <code><nowiki> http://wiki.services.openoffice.org/wiki/documentation/</nowiki>''Article''</code>  
+
* If you want to create a really new page for the Documentation project, you can use the wiki's URL for creating a new page. You should observe the wiki page tree when you create a new page in this way. The URL to a wiki page is then something like this: <br>  <tt><nowiki> http://wiki.services.openoffice.org/wiki/documentation/</nowiki>''Page Name''</tt>  
 +
* However, the recommended method is to search for the desired page name (in the Search field above left), and when the page does not exist, you will be offered to "create this page" by clicking on a link on the Search Results Page.
  
{{Documentation/Note | The URL approach is only useful if you link the page later to other pages. Otherwise it will be hidden in the wiki.}}
+
{{Note | The URL approach is only useful if you link the page later to other pages. Otherwise it will be hidden in the wiki.}}
  
 
For more information about new pages see the [http://www.mediawiki.org/wiki/Help:Starting_a_new_page Mediawiki help about new pages]
 
For more information about new pages see the [http://www.mediawiki.org/wiki/Help:Starting_a_new_page Mediawiki help about new pages]
Line 119: Line 123:
 
# Click '''Special pages''' in the toolbox on the left side.
 
# Click '''Special pages''' in the toolbox on the left side.
 
# Click '''Categories''' in the Special pages link list.
 
# Click '''Categories''' in the Special pages link list.
# Choose a Category name that makes sense, and apply it by adding <code>[[Category:''Category Name'']]</code> at the end of the page.
+
# Choose a Category name that makes sense, and apply it by adding <tt><nowiki>[[Category:''Category Name'']]</nowiki></tt> at the end of the page.
  
{{Documentation/Caution | Do not create duplicate Categories for the same topic. Each Category must be unique. Otherwise it will be difficult to use the Categories for searching the wiki.}}
+
{{Warn | Do not create duplicate Categories for the same topic. Each Category must be unique. Otherwise it will be difficult to use the Categories for searching the wiki.}}
  
 
Look at [http://www.mediawiki.org/wiki/Help:Categories MediaWiki Help:Categories] if you want to know more about Wiki Categories.
 
Look at [http://www.mediawiki.org/wiki/Help:Categories MediaWiki Help:Categories] if you want to know more about Wiki Categories.
Line 141: Line 145:
  
 
==Adding a new Documentation Template==
 
==Adding a new Documentation Template==
 
+
<section begin=addingtemplate />
 
* If you create a new template to be used in the wiki documentation, name it as a subpage of '''Documentation'''.
 
* If you create a new template to be used in the wiki documentation, name it as a subpage of '''Documentation'''.
** wrong: <code>mytemplate</code>
+
** wrong: <tt>mytemplate</tt>
** right: <code>Documentation/mytemplate</code>
+
** right: <tt>Documentation/mytemplate</tt>
  
* Add a description of the template purpose and usage to the template itself using the <code><noinclude></code> element as described in [http://meta.wikimedia.org/wiki/Help:Template#Noinclude.2C_includeonly.2C_and_onlyinclude Mediawiki help: Template].
+
* Add a description of the template purpose and usage to the template itself using the <code><noinclude></code> element as described in [http://meta.wikimedia.org/wiki/Help:Template#Noinclude.2C_includeonly.2C_and_onlyinclude MediaWiki help: Template].
  
 
* Add the template to the list of templates below.
 
* Add the template to the list of templates below.
 
+
<section end=addingtemplate />
 
{{Spacer|30}}
 
{{Spacer|30}}
  
==List of Existing Documentation Templates==
+
== List of Existing Documentation Templates ==
  
This is a list of Documentation templates and their usage
+
<section begin="doctemplates" /> This is a list of Documentation templates and their usage  
 +
 
 +
{| cellspacing="4" cellpadding="3" border="1" style="border-collapse: collapse;"
 +
|-
 +
! Template Name
 +
! Usage
 +
! Example
 +
|-
 +
| [[Template:Mt]]
 +
| Service template for marking multilingual templates. {{Tlp|Mt|EN}}
 +
 
 +
'''This template itself is also multilanguage.'''
 +
 
 +
Displays the following message:
 +
| {{Mt|EN}}
 +
|-
 +
| [[Template:Revision]]
 +
|  {{Mt|EN}}
 +
This template is intended to mark pages that need revision. {{Tlp|Revision|EN}}
 +
| {{Revision|EN}}
 +
|-
 +
| [[Template:DocBanner]]
 +
| Puts the Documentation Project "Banner" at the top right of the page
 +
{{Tlp|DocBanner}}
 +
 
 +
| [[Image:Docbanner.png]]
 +
|-
 +
| [[Template:OOoLogo]]
 +
| Displays an OpenOffice.org logo
 +
{{Tlp|OOoLogo}}
 +
 
 +
| {{OOoLogo}}
 +
|-
 +
| [[Template:PDF]]
 +
| {{Tlp|PDF}}
 +
| {{PDF}}
 +
|-
 +
| [[Template:OOo]]
 +
| A variable for displaying the string '''OpenOffice.org'''.
 +
{{Tlp|OOo}}
 +
 
 +
| {{OOo}}
 +
|-
 +
| [[Template:AOo]]
 +
| A variable for displyaing the string '''Apache OpenOffice'''
 +
{{Tlp|AOo}}
 +
| {{AOo}}
 +
|-
 +
| [[Template:Bar]]
 +
| Used to draw horizontal bars for simplistic bar charts
 +
{{Tlp|Bar|100|10|#3333FF}}<br>
 +
{{Tlp|Bar|57|10|#33FF33}}<br>
 +
{{Tlp|Bar|112|10|#FF3333}}
 +
|
 +
{{Bar|100|10|#3333FF}}
 +
{{Bar|57|10|#33FF33}}
 +
{{Bar|112|10|#FF3333}}
 +
|-
 +
| [[Template:BeingEdited]]
 +
| {{Mt|EN}}
 +
Marks a page as currently being edited to avoid conflicting changes.
 +
Use this template when you perform larger edits on a file that may even take more than one session to finish. Be sure to add name and date of "locking" by adding a <tt><code><nowiki>~~~~</nowiki></code></tt> as parameter: {{Tlp|BeingEdited|EN|[[User:Sancho|А. Е. Харламенков]] ([[User talk:Sancho|talk]]) 10:40, 6 July 2018 (UTC)|1}}
 +
 
 +
| {{BeingEdited|EN|[[User:Fpe|Fpe]] 17:54, 7 February 2008 (CET)|1}}
 +
|-
 +
| [[Template:NeedsRework]]
 +
| {{Mt|EN}}
 +
Marking an article to check for accuracy and consistency with the style.
 +
{{Tlp|NeedsRework|EN}}
 +
| {{NeedsRework|EN|1}}
 +
|-
 +
| [[Template:HelpNeeded]]
 +
| {{Mt|EN}}
 +
{{Tlp|HelpNeeded|EN|Check the spelling}}
 +
| {{HelpNeeded|EN|Check the spelling|1}}
 +
|-
 +
| [[Template:Old]]
 +
| {{Mt|EN}}
 +
Identifies a page that is obsolete
 +
{{Tlp|Old|EN}}
 +
| {{Old|EN|1}}
 +
|-
 +
| [[Template:DraftPage]]
 +
| {{Mt|EN}}
 +
Marks up pages that are in a draft state
 +
{{Tlp|DraftPage|EN}}
 +
| {{DraftPage|EN|1}}
 +
|-
 +
| [[Template:CoreCriticalTemplate]]
 +
| This template is intended to mark the Core Critical Template, unconsidered intervention in the template may result in the destruction of the entire project!
 +
{{Tlp|CoreCriticalTemplate}}
 +
| {{CoreCriticalTemplate|1}}
 +
|-
 +
| [[Template:Imported]]
 +
| {{Mt|EN}}
 +
{{Tlp|Imported|EN|Author Name|Contributor Names}}
 +
| {{Imported|EN|Author Name|Contributor Names}}
 +
|-
 +
| [[Template:Win]]
 +
| Displays a Windows logo and allows to enter Windows specific content.
 +
{{Tlp|Win|Windows related content}}
 +
| {{Win|Windows related content}}
 +
|-
 +
| [[Template:Lin]]
 +
| Displays a Linux logo and allows to enter Linux specific content.
 +
{{Tlp|Lin|Linux related content}}
 +
| {{Lin|Linux related content}}
 +
|-
 +
| [[Template:Mac]]
 +
| Displays an Apple/OSX logo and allows to enter OSX specific content
 +
{{Tlp|Mac | Mac related content}}
 +
| {{Mac | Mac related content}}
 +
|-
 +
| [[Template:Bug]]
 +
| Links to Issuezilla issue.
 +
{{Tlp|Bug|123456}}
 +
| {{Bug|123456}}
 +
|-
 +
| [[Template:Note]]
 +
| Takes sections containing notes,i.e. related, reinforcing information, for example, an explanation or comment.
 +
{{Tlp|Note|Notable stuff}}
 +
| {{Note|Notable stuff}}
 +
|-
 +
| [[Template:Tip]]
 +
| Takes sections containing tips, i.e. useful non-crucial information, for example, a keyboard shortcut.
 +
{{Tlp|Tip|Right-click opens the context menu}}
 +
 
 +
| {{Tip|Right-click opens the context menu}}
 +
|-
 +
| [[Template:Warn]]
 +
| Takes sections containing warnings, i.e. information that is potentially harmful in some way, for example, data loss.
 +
{{Tlp|Warn|Always switch off power before opening the case.}}
 +
| {{Warn|Always switch off power before opening the case.}}
 +
|-
 +
| [[Template:SeeAlso]]
 +
| {{Mt|EN}}
 +
{{Tlp|SeeAlso|EN|
 +
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 +
* DevGuide/SeeAlso version is used in the Developer's Guide and is set to be excluded from generated PDF and ODT books.}}
 +
| {{SeeAlso|EN|
 +
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 +
* DevGuide/SeeAlso version is used in the Developer's Guide and is set to be excluded from generated PDF and ODT books.
 +
}}
 +
|-
 +
| [[Template:HeaderBlock]]
 +
| Ornamental template.
 +
Designed to process the most important links in the form of the similarity of a button.
 +
{{Tlp|HeaderBlock|[[Documentation]]}}
 +
| {{HeaderBlock|[[Documentation]]}}
 +
|-
 +
| [[Template:FromForum]]
 +
| {{Mt|EN}}
 +
{{Tlp|FromForum|EN}}
 +
| {{FromForum|EN}}
 +
|-
 +
| Template:Documentation/*TOC
 +
| Several tables of content based on [[Template:Documentation/MasterTOC]] used in guides.
 +
| See, for example, the [[Template:Documentation/BASICGuideTOC/v2|Basic Guide TOC]]
 +
|-
 +
| [[Template:Documentation/MasterTOC]]
 +
| This is the master template that is used to create tables of content. For usage click the template name.
 +
|
 +
|-
 +
| [[Template:OOoVersion]]
 +
| {{Mt|EN}}
 +
This template is used to insert an OpenOffice.org version box on a page. Multilingual templates. This template is designed to be inserted into the article notes about the version of OpenOffice.org, to which the article.
 +
{{Tlp|OOoVersion|EN|1.1.x}}
 +
| {{OOoVersion|EN|1.1.x}}
 +
|-
 +
| [[Template:AOoVersion]]
 +
| {{Mt|EN}}
 +
This template is used to insert an ApacheOpenOffice version box on a page.
 +
{{Tlp|AOoVersion|EN|4.1.x}}
 +
| {{AOoVersion|EN|4.1.x}}
 +
|-
 +
| [[Template:OOoW]]
 +
| This template is used to insert an  '''{{OOoW}}''' string in text.
 +
{{Tlp|OOoW}}<br>{{Tlp|OOoW|1}}
 +
| {{OOoW}}<br>{{OOoW|1}}
 +
|-
 +
| [[Template:OOoC]]
 +
| This template is used to insert an  '''{{OOoC}}''' string in text.
 +
{{Tlp|OOoC}}<br>{{Tlp|OOoC|1}}
 +
| {{OOoC}}<br>{{OOoC|1}}
 +
|-
 +
| [[Template:OOoCh]]
 +
| This template is used to insert an  '''{{OOoCh}}''' string in text.
 +
{{Tl|OOoCh}}<br>{{Tlp|OOoCh|1}}
 +
| {{OOoCh}}<br>{{OOoCh|1}}
 +
|-
 +
| [[Template:OOoI]]
 +
| This template is used to insert an  '''{{OOoI}}''' string in text.
 +
{{Tlp|OOoI}}<br>{{Tlp|OOoI|1}}
 +
| {{OOoI}}<br>{{OOoI|1}}
 +
|-
 +
| [[Template:OOoD]]
 +
| This template is used to insert an  '''{{OOoD}}''' string in text.
 +
{{Tlp|OOoD}}<br>{{Tlp|OOoD|1}}
 +
| {{OOoD}}<br>{{OOoD|1}}
 +
|-
 +
| [[Template:OOoB]]
 +
| This template is used to insert an  '''{{OOoB}}''' string in text.
 +
{{Tlp|OOoB}}<br>{{Tlp|OOoB|1}}
 +
| {{OOoB}}<br>{{OOoB|1}}
 +
|-
 +
| [[Template:OOoM]]
 +
| This template is used to insert an  '''{{OOoM}}''' string in text.
 +
{{Tlp|OOoM}}<br>{{Tlp|OOoM|1}}
 +
| {{OOoM}}<br>{{OOoM|1}}
 +
|-
 +
| [[Template:POOo]]
 +
| This template is used to insert an '''{{POOo}}''' string in text.
 +
{{Tlp|POOo}}
 +
| {{POOo}}
 +
|-
 +
| [[Template:SRB]]
 +
| This template is used to insert an  '''{{SRB}}''' string in text.
 +
{{Tlp|SRB}}<br>{{Tlp|SRB|1}}
 +
| {{SRB}}<br>{{SRB|1}}
 +
|-
 +
| [[Template:MSO]]
 +
| This template is used to insert an  '''Microsoft Office''' string in text.
 +
{{Tlp|MSO}}
 +
| {{MSO}}
 +
|-
 +
| [[Template:MSO2003]]
 +
| This template is used to insert an  '''Microsoft Office 2003''' string in text.
 +
{{Tlp|MSO2003}}<br>{{Tlp|MSO2003|1}}
 +
| {{MSO2003}}<br>{{MSO2003|1}}
 +
|-
 +
| [[Template:MSO2010]]
 +
| This template is used to insert an  '''Microsoft Office 2010''' string in text.
 +
{{Tlp|MSO2010}}<br>{{Tlp|MSO2010|1}}
 +
| {{MSO2010}}<br>{{MSO2010|1}}
 +
|-
 +
| [[Template:MSW]]
 +
| This template is used to insert an '''MS Word''' string in text.
 +
{{Tlp|MSW}}<br>{{Tlp|MSW|1}}
 +
| {{MSW}}<br>{{MSW|1}}
 +
|-
 +
| [[Template:MSE]]
 +
| This template is used to insert an '''MS Excel''' string in text.
 +
{{Tlp|MSE}}<br>{{Tlp|MSE|1}}
 +
| {{MSE}}<br>{{MSE|1}}
 +
|-
 +
| [[Template:MSA]]
 +
| This template is used to insert an '''MS Access''' string in text.
 +
{{Tlp|MSA}}<br>{{Tlp|MSA|1}}
 +
| {{MSA}}<br>{{MSA|1}}
 +
|-
 +
| [[Template:MSPP]]
 +
| This template is used to insert an '''MS Power Point''' string in text.
 +
{{Tlp|MSPP}}<br>{{Tlp|MSPP|1}}
 +
| {{MSPP}}<br>{{MSPP|1}}
 +
|-
 +
| [[Template:MSEq]]
 +
| This template is used to insert an '''MS Equation''' string in text.
 +
{{Tlp|MSEq}}<br>{{Tlp|MSEq|1}}
 +
| {{MSEq}}<br>{{MSEq|1}}
 +
|-
 +
| [[Template:MSV]]
 +
| This template is used to insert an '''{{MSV}}''' string in text.
 +
{{Tlp|MSV}}<br>{{Tlp|MSV|1}}
 +
| {{MSV}}<br>{{MSV|1}}
 +
|-
 +
| [[Template:Key]]
 +
| This template is used to insert keycodes in text.
 +
{{Tlp|Key|Ctrl|Shift|>}}
 +
| {{Key|Ctrl|Shift|>}}
 +
|-
 +
| [[Template:Button]]
 +
| This template is used to insert an article in the notation of buttons on-screen dialogues.
 +
{{Tlp|Button|Ok}}
 +
| {{Button|Ok}}
 +
|-
 +
| [[Template:QuoteEn]]
 +
| The template is designed for inserting quotations in the text.
 +
{{Tlp|QuoteEn|quote&#61;OpenOffice.org 3 is the leading open-source office software suite for word processing, spreadsheets, presentations, graphics, databases and more.
 +
|author&#61;why.openoffice.org}}
 +
| {{QuoteEn|quote=OpenOffice.org 3 is the leading open-source office software suite for word processing, spreadsheets, presentations, graphics, databases and more.|author=why.openoffice.org}}
 +
|-
 +
| [[Template:Menu]]
 +
| This template is designed to insert text anywhere in the chain menu.
 +
{{Tlp|Menu|File|Open|Print|4|5|6|7|8|9|10}}
 +
| {{Menu|File|Open|Print|4|5|6|7|8|9|10}}
 +
 
 +
|-
 +
| [[Template:Path]]
 +
| This template using to format file system path.
 +
{{Tlp|Path|C:\Program files\OpenOffice.org}}
 +
| {{Path|C:\Program files\OpenOffice.org}}
  
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 
|-valign=top
 
!Template Name!!Usage!!Example
 
|-valign=top
 
|[[Template:Documentation/Abstract]]
 
|Takes a short abstract of the chapter content of guides. Add to the top of guides.
 
<tt><code><nowiki>{{Documentation/Abstract|Abstract Text}}</nowiki></code></tt>
 
|See, for example, [[Documentation/Administration_Guide/Customizing|this Administration Guide Chapter]]
 
|-valign=top
 
|[[Template:Documentation/Banner]]
 
|Puts the Documentation Project "Banner" at the top right of the page
 
<tt><code><nowiki>{{Documentation/Banner}}</nowiki></code></tt>
 
|[[Image:Docbanner.png]]
 
|-valign=top
 
|[[Template:Documentation/BeingEdited]]
 
|Marks a page as currently being edited to avoid conflicting changes.
 
Use this template when you perform larger edits on a file that may even take more than one session to finish.
 
Be sure to add name and date of "locking" by adding a <tt><code><nowiki>~~~~</nowiki></code></tt> as parameter:
 
<tt><code><nowiki>{{Documentation/BeingEdited|~~~~}}</nowiki></code></tt>
 
|{{Documentation/BeingEdited|[[User:Fpe|Fpe]] 17:54, 7 February 2008 (CET)}}
 
|-valign=top
 
|[[Template:Documentation/Caution]]
 
|Takes sections containing warnings, i.e. information that is potentially harmful in some way, for example, data loss.
 
<tt><code><nowiki>{{Documentation/Caution|Always switch off power before opening the case.}}</nowiki></code></tt>
 
|{{Documentation/Caution|Always switch off power before opening the case.}}
 
|-valign=top
 
|[[Template:Documentation/CheckedAccuracy]]
 
|Marks up pages that have been reviewed for accuracy.
 
Be sure to add name and date of review by adding a <tt><code><nowiki>~~~~</nowiki></code></tt> as parameter:
 
<tt><code><nowiki>{{Documentation/CheckedAccuracy|~~~~}}</nowiki></code></tt>
 
|{{Documentation/CheckedAccuracy|John Doe}}
 
|-valign=top
 
|[[Template:Documentation/DraftPage]]
 
|Marks up pages that are in a draft state
 
<tt><code><nowiki>{{Documentation/DraftPage}}</nowiki></code></tt>
 
|{{Documentation/DraftPage}}
 
|-valign=top
 
|[[Template:Documentation/hbar]]
 
|Used to draw horizontal bars for simplistic bar charts
 
|
 
{{Documentation/hbar|width=100|bg=#3333FF}}
 
{{Documentation/hbar|width=57|bg=#33FF33}}
 
{{Documentation/hbar|width=112|bg=#FF3333}}
 
|-valign=top
 
|[[Template:Documentation/HelpNeeded]]
 
|<tt><code><nowiki>{{Documentation/HelpNeeded|Check the spelling}}</nowiki></code></tt>
 
|{{Documentation/HelpNeeded|Check the spelling}}
 
|-valign=top
 
|[[Template:Documentation/Imported]]
 
|<tt><code><nowiki>{{Documentation/Imported|author=Author Name|contributors=Contributor Names}}</nowiki></code></tt>
 
|{{Documentation/Imported|author=Author Name|contributors=Contributor Names}}
 
|-valign=top
 
|[[Template:Documentation/Linux]]
 
|<tt><code><nowiki>{{Documentation/Linux|Linux related content}}</nowiki></code></tt>
 
|{{Documentation/Linux|Linux related content}}
 
|-valign=top
 
|[[Template:Documentation/MasterTOC]]
 
|This is the master template that is used to create tables of content. For usage click the template name.
 
|
 
|-valign=top
 
|[[Template:Documentation/NeedsRework]]
 
|<tt><code><nowiki>{{Documentation/NeedsRework}}</nowiki></code></tt>
 
|{{Documentation/NeedsRework}}
 
|-valign=top
 
|[[Template:Documentation/Note]]
 
|<tt><code><nowiki>{{Documentation/Note|Notable stuff}}</nowiki></code></tt>
 
|{{Documentation/Note|Notable stuff}}
 
|-valign=top
 
|[[Template:Documentation/OOo]]
 
|Displays an OpenOfiice.org logo
 
<tt><code><nowiki>{{Documentation/OOo}}</nowiki></code></tt>
 
|{{Documentation/OOo}}
 
|-valign=top
 
|[[Template:Documentation/Outdated]]
 
|<tt><code><nowiki>{{Documentation/Outdated}}</nowiki></code></tt>
 
|{{Documentation/Outdated}}
 
|-valign=top
 
|[[Template:Documentation/PDF]]
 
|<tt><code><nowiki>{{Documentation/PDF}}</nowiki></code></tt>
 
|{{Documentation/PDF}}
 
|-valign=top
 
|[[Template:Documentation/PRODUCTNAME]]
 
|A variable for displaying the string '''OpenOffice.org'''.
 
<tt><code><nowiki>{{Documentation/PRODUCTNAME}}</nowiki></code></tt>
 
|{{Documentation/PRODUCTNAME}}
 
|-valign=top
 
|[[Template:Documentation/Tip]]
 
|Takes sections containing tips, i.e. useful non-crucial information.
 
<tt><code><nowiki>{{Documentation/Tip|Right-click opens the context menu}}</nowiki></code></tt>
 
|{{Documentation/Tip|Right-click opens the context menu}}
 
|-valign=top
 
|Template:Documentation/*TOC
 
|Several tables of content based on [[Template:Documentation/MasterTOC]] used in guides.
 
|See, for example, the [[Template:Documentation/BASICGuideTOC/v2|Basic Guide TOC]]
 
|-valign=top
 
|[[Template:Documentation/Windows]]
 
|<tt><code><nowiki>{{Documentation/Windows|Windows related content}}</nowiki></code></tt>
 
|{{Documentation/Windows|Windows related content}}
 
|-valign=top
 
|[[Template:Documentation/FromForum]]
 
|<tt><code><nowiki>{{Documentation/FromForum}}</nowiki></code></tt>
 
|{{Documentation/FromForum}}
 
 
|}
 
|}
  
=Graphical Content=
+
<section end="doctemplates" />
  
Before you can insert your well prepared image in a wiki page you have to upload it. In the sidebar, under '''toolbox''', click '''Upload file'''.
+
=Graphical Content=
  
 
General guidelines for images are:
 
General guidelines for images are:
* Use the image description page to describe an image and copyright status (if any).
+
* Use a descriptive and unique title. The filename should be constructed in a way so it shows the usage, e.g. Doc_mig_icon_data.png = '''Doc'''umentation image, used in the '''mig'''ration guide, depicting the '''data'''base '''icon'''.
* Use a descriptive and unique title.  
+
* If possible, do not pre-scale the images you are uploading.  You can use the MediaWiki image thumbnail feature to scale the image.
* Images cannot be hierarchical, filename should be constructed in a way so it shows the usage, e.g. Doc_mig_icon_data.png = '''Doc'''umentation image, used in the '''mig'''ration guide, depicting the '''data'''base '''icon'''.
+
* If possible, do not pre-scale the images you are uploading.  Use the MediaWiki image thumbnail feature to scale the image.
+
 
* Edit the image if necessary to make sure that the important part is clear and visible.
 
* Edit the image if necessary to make sure that the important part is clear and visible.
 
* Keep in mind that people may be translating the page where you are placing an image.  Try not to include callouts or other extra text on the image.
 
* Keep in mind that people may be translating the page where you are placing an image.  Try not to include callouts or other extra text on the image.
 
* JPG is usually best for photos, SVG, for icons, logos etc, and PNG for screen captures.  Try not to use BMP.
 
* JPG is usually best for photos, SVG, for icons, logos etc, and PNG for screen captures.  Try not to use BMP.
  
When you place the image on a page you can use the MediaWiki Image thumb feature to "wrap" your illustrations in an image box.  This image box includes a spot for an image caption.  The syntax is <code>[[Image:''image.png|thumb|position|size|Image caption'']]</code>, where:
+
 
 +
Before you can insert your well prepared image in a wiki page you have to upload it.
 +
# In the sidebar, under '''toolbox''', click '''Upload file'''. The image description page will appear.
 +
# Use the image description page to describe an image and copyright status (if any).
 +
 
 +
 
 +
To place the image on a page you can use the MediaWiki Image thumbnail feature which "wraps" your illustrations in an image box.  This image box includes a spot for an image caption.  The syntax is <tt>[[Image:''image.png|thumb|position|size|Image caption'']]</tt>, where:
 
* thumb = thumbnail the image and wrap in an image box
 
* thumb = thumbnail the image and wrap in an image box
 
* position = position on page. "none" places the image on the left of the frame with no text wrapping. "left" and "right" places the image on the left or right of the page with full text wrapping.
 
* position = position on page. "none" places the image on the left of the frame with no text wrapping. "left" and "right" places the image on the left or right of the page with full text wrapping.
Line 279: Line 475:
 
If you do not declare a position and size, the image is scaled to a small thumbnail, and defaults to the right hand side of the page with full text wrapping.
 
If you do not declare a position and size, the image is scaled to a small thumbnail, and defaults to the right hand side of the page with full text wrapping.
  
Here is an example using <code><nowiki>[[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]</nowiki></code>
+
Here is an example using <tt><nowiki>[[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]</nowiki></tt>
  
 
[[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]
 
[[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]
Line 297: Line 493:
 
Editing is only possible after login. You can start editing the whole page after clicking the '''edit''' tab at the top. But usually it is more comfortable to edit individual sections of a page by clicking one of the '''[edit]''' links on the right side. If you make changes, please consider the rules of the [[Documentation/Dashboard/Help_Style_Guide | style guide]] to assure a consistent writing style. Click the '''Show preview''' button before you save the page finally.
 
Editing is only possible after login. You can start editing the whole page after clicking the '''edit''' tab at the top. But usually it is more comfortable to edit individual sections of a page by clicking one of the '''[edit]''' links on the right side. If you make changes, please consider the rules of the [[Documentation/Dashboard/Help_Style_Guide | style guide]] to assure a consistent writing style. Click the '''Show preview''' button before you save the page finally.
  
==Fixing inappropriate, inaccurate, or outdated content==
+
== Fixing inappropriate, inaccurate, or outdated content ==
  
Contents that are not up to date are usually marked by one of the following labels:
+
Contents that are not up to date are usually marked by one of the following labels:  
{{Documentation/Outdated}}
+
{{Documentation/NeedsRework}}
+
You can find a collection of articles with the latter label if you click on [[:Category:Documentation/NeedsRework | Pages that Need Help! ]] on the Wiki main page.
+
  
When you have selected an article to work on
+
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
#test whether the described procedures are still valid for the current version of OpenOffice.org.
+
|- valign=top
#log in and make the necessary corrections.  
+
| {{Old|EN|1}}
 +
| This label means that an article is outdated as a whole and needs to be revised completely.
 +
|- valign=top
 +
| {{HelpNeeded|EN|works for OOo 2, needs to be confirmed for OOo 3|1}}
 +
| If an article is partly outdated or inaccurate you may find this label asking for specific help.
 +
|- valign=top
 +
| {{NeedsRework|EN|1}}
 +
| You can find a collection of pages with this label if you click on [[:Category:NeedsRework|Pages that Need Help! ]] on the Wiki main page.
 +
|}
  
This works best when you open two tabs in the browser, one for reading the procedures and another for editing.
+
When you have selected a page to work on
  
When you have finished, remove the above label(s), mark the page with the label "Checked for technical accuracy" (as described in the [[Documentation/Dashboard/Wiki_Editing_Policy#List_of_Existing_Documentation_Templates | Templates]] section above), and click '''Save page'''.
+
#test whether the described procedures are still valid for the current version of OpenOffice.org.
 +
#log in and make the necessary corrections.
 +
 
 +
This works best when you open two tabs in the browser, one for reading the procedures and another for editing.
 +
 
 +
When you have finished, remove the above label(s), mark the page with the label "Checked for technical accuracy" (as described in the [[Documentation/Dashboard/Wiki Editing Policy#List_of_Existing_Documentation_Templates|Templates]] section above), and click '''Save page'''.
  
 
==Fixing minor errors and typos==
 
==Fixing minor errors and typos==
Line 317: Line 523:
  
 
==Fixing graphics and screenshots==
 
==Fixing graphics and screenshots==
 +
 +
To edit a graphic in the wiki, right-click the graphic and choose '''Save image as'''. When you have edited the graphic on your computer, go back to the wiki page, click the graphic, and in the image description page choose '''Upload a new version of this file'''.
 +
 +
If you have created a new version of a screenshot, directly click the corresponding screenshot in the wiki and then '''Upload a new version of this file''' in the image description page.
  
 
==Fixing Style and Language==
 
==Fixing Style and Language==
  
 
Articles that need improvement in style and language might be recognized by the following labels:
 
Articles that need improvement in style and language might be recognized by the following labels:
{{Documentation/HelpNeeded|Check the spelling}}
+
{{HelpNeeded|EN|Check the spelling|1}}
{{Documentation/NeedsRework}}
+
{{NeedsRework|EN|1}}
You can find a collection of articles with the latter label if you click on [[:Category:Documentation/NeedsRework | Pages that Need Help! ]] on the Wiki main page.
+
You can find a collection of articles with the latter label if you click on [[:Category:NeedsRework | Pages that Need Help! ]] on the Wiki main page.
  
 
To improve such an article, just log in, click on the edit tab and make the necessary corrections. Then remove the label(s) and click on '''Save page'''.
 
To improve such an article, just log in, click on the edit tab and make the necessary corrections. Then remove the label(s) and click on '''Save page'''.
  
 
==Linking to localized pages==
 
==Linking to localized pages==
 +
 +
* Link the various languages to each other using the Interwiki links syntax <tt><nowiki>[[ISO_Lang_code:Page_Title]]</nowiki></tt>. <br> For example, <tt><nowiki>[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]</nowiki></tt> adds a link to the Chinese translation of the first page of the Developer's Guide.  This link shows in the left column, under the heading "In other languages". This may be more practical to do with Wiki Templates as more languages are added.
 +
* In the Developer's guide we use a template to link translated pages. <br> The Wiki Syntax is: <tt><nowiki>
 +
{{Documentation/DevGuideLanguages|Page_Title}}</nowiki></tt> where Page_Title is the current Wiki page name. <br> For example, <tt><nowiki>{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org
 +
Developers Guide}}</nowiki></tt> will add the localized page links for the first page in the Developer's Guide. <br> If you want to see a link to your language at the Developer's Guide wiki pages simply add your language to the template [[Template:Documentation/DevGuideLanguages]]. For example, for Dutch you would have to add <tt><nowiki>[[nl:NL/{{{1}}}]]</nowiki></tt>. Make sure the template is referenced correctly in each of the translated pages.
  
 
==Validating Content==
 
==Validating Content==
  
==Fixing Spam /Deleting Pages==
+
==Fixing Spam / Deleting Pages==
  
If you detect spam you can send a mail to [mailto:dev@website.openoffice.org dev@website.openoffice.org].  
+
If you detect spam you can send an email to [mailto:dev@openoffice.apache.org the dev@ list].  
  
There is also a [http://wiki.services.openoffice.org/wiki/Special:Listusers/sysop list with Wiki Sysops] (people who can delete pages). If you want to have pages deleted, you can either ask someone from that list, or better, add the Wiki Syntax <code><nowiki>{{delete}}</nowiki></code> anywhere on the page you want to be deleted. This will add the page to the "Candidates for speedy deletion" category, and the page will be deleted by someone with Sysop privileges, or by WikiBot maintenance.
+
There is also a [[Special:Listusers/sysop|list of Wiki Sysops]] (people who can delete pages). If you want to have pages deleted, you can either ask someone from that list, or better, add the Wiki Syntax <tt><nowiki>{{delete}}</nowiki></tt> anywhere on the page you want to be deleted. This will add the page to the "Candidates for speedy deletion" category, and the page will be deleted by someone with Sysop privileges, or by WikiBot maintenance.
  
 
=Working on FAQs=
 
=Working on FAQs=
 
Every question together with its answer is displayed on one single wiki page.  
 
Every question together with its answer is displayed on one single wiki page.  
  
If you want to insert a new FAQ:
+
If you want to insert a new FAQ entry, that is, a pair of a question together with the corresponding answer:
* Select a FAQ section on the main page of the Documentation Wiki. In Writer you have to select another subpage until you reach a final FAQ section.
+
<ol>
* Click '''Add New FAQ'''<br>A new wiki page will be created and preloaded with a template for a Q/A pair:  
+
<li> Select a FAQ section on the main page of the Documentation Wiki. In Writer and Calc you have to select another subpage until you reach a final FAQ section.</li>
 +
<li> Scroll down to the Insert New FAQ listbox.</li>
 +
<li> Replace the text in the listbox after the last slash '/' with your question.</li>
 +
<li> Click '''Add New FAQ'''<br>A new wiki page will be created and preloaded with a template for a Q/A pair:  
  
 
<source lang="text">
 
<source lang="text">
Line 359: Line 577:
 
</source>
 
</source>
  
* Replace <code>(INSERT FAQ TITLE)</code> with the title of the FAQ as displayed on the page. This may be a short version of the question or the question itself.
+
</li>
* Replace <code><INSERT QUESTION></code> with the actual question.
+
 
* Replace <code><INSERT ANSWER></code> with the actual answer
+
<li> Replace <tt>(INSERT FAQ TITLE)</tt> with the title of the FAQ to be displayed on the page. This may be a short version of the question or the question itself.</li>
* Replace <code><INSERT FAQ SECTION></code> with the current FAQ section name. This category assignment determines where this wiki page will appear. Please use the following section names:
+
<li> Replace <tt><INSERT QUESTION></tt> with the actual question.</li>
 +
<li> Replace <tt><INSERT ANSWER></tt> with the actual answer.</li>
 +
<li> Replace <tt><INSERT FAQ SECTION></tt> with the current FAQ section name. This category assignment determines where this wiki page will appear. Please use the following section names:</li>
  
 
{|class="prettytable sortable"
 
{|class="prettytable sortable"
Line 400: Line 620:
 
|Macros||Macros
 
|Macros||Macros
 
|}
 
|}
* Click '''Save Page'''
+
<li>Click '''Save Page'''.</li>
 +
</ol>
  
 
=Working on How Tos=
 
=Working on How Tos=
Line 409: Line 630:
 
# Click the link to your How To and start writing by using the rules of the [[Documentation/Dashboard/Help_Style_Guide | style guide]]. If you are not sure about how to implement the style guide, have a look at the Writer How To [[Documentation/How_Tos/Getting_a_Picture_into_the_Gallery | Getting a Picture Into the Gallery]].
 
# Click the link to your How To and start writing by using the rules of the [[Documentation/Dashboard/Help_Style_Guide | style guide]]. If you are not sure about how to implement the style guide, have a look at the Writer How To [[Documentation/How_Tos/Getting_a_Picture_into_the_Gallery | Getting a Picture Into the Gallery]].
  
{{Documentation/Note|Always put the licence link at the end of your article: Simply insert <code><nowiki>{{PDL1}}</nowiki></code>. }}
+
{{Note|Always put the licence link at the end of your article: Simply insert <tt><nowiki>{{PDL1}}</nowiki></tt>. }}
 +
 
 +
You can also create How Tos by writing a new page like <tt>Documentation/How Tos/''Page Name''</tt> with one or more specific categories. The newly created How To page will then be assigned to the corresponding How To sections. The available categories for that are the following:
 +
* <tt><nowiki>[[Category:Documentation/How Tos/Installation]]</nowiki></tt>
 +
* <tt><nowiki>[[Category:Documentation/How Tos/Writer]]</nowiki></tt>
 +
* <tt><nowiki>[[Category:Documentation/How Tos/Impress]]</nowiki></tt>
 +
* <tt><nowiki>[[Category:Documentation/How Tos/Calc]]</nowiki></tt>
 +
* <tt><nowiki>[[Category:Documentation/How Tos/Database]]</nowiki></tt>
  
  
Line 423: Line 651:
  
 
=Working on Guides=
 
=Working on Guides=
 +
Currently, there are the following guides on the wiki:
 +
* [[Documentation/Administration_Guide|The Administration Guide]]
 +
* [[Documentation/BASIC_Guide|The BASIC  Programming Guide]]
 +
* [[Documentation/Building_Guide|The Building Guide (OO.o from source)]]
 +
* [[Documentation/DevGuide/OpenOffice.org_Developers_Guide|The Developer's Guide]]
 +
* [[Documentation/OOoAuthors_User_Manual|The User Guides for OpenOffice.org 2.x]]
 +
* [[Documentation/OOo3_User_Guides|The User Guides for OpenOffice.org 3.x]]
 +
 +
If you want to work on the User Guides for OpenOffice.org please contact the [http://www.oooauthors.org OOoAuthors group].
  
 +
There is some help available about [[Documentation/DevGuide/Contributing_to_the_Developers_Guide|Contributing to the Developer's Guide]] which may also be useful for the Administration Guide and the BASIC Programming Guide.
  
 
=Localizing Content=
 
=Localizing Content=
  
 +
{{#lst:Help:Translating|translating}}
  
 
{{PDL1}}
 
{{PDL1}}
  
 
[[Category:Help]]
 
[[Category:Help]]
 +
[[Category:How to]]
 +
[[Category:Guidelines]]
 +
[[Category:Localization]]
 +
[[Category:Documentation/Dashboard]]

Revision as of 22:21, 4 January 2019

doc OOo


This article helps you to contribute effectively to the Documentation part of the wiki. We strongly encourage you to announce new pages or major changes to the mailing list doc@openoffice.apache.org.


Project-independent ruleset

Documentation note.png See the general project-independent rules at OOo_Wiki_Contribution_Rules first!

Prerequisites for Editing

You must be registered and logged in before you can edit the Wiki. Registration is easily done.

  1. Click on Log in / create account in the upper right corner of the screen and enter the required bits.
  2. Subsequently you have to validate your email address.

For further logins you use the same entry point, enter Username and Password, and click the Log in button.

Documentation caution.png To combat vandalism, newly registered users cannot edit any page or create a new page until a four (4) day "cooling off period" has elapsed.

The next step could be to tell the Community about yourself. There is definitely no harm and it is a good way of getting comfortable with the Wiki.

  1. When you are logged in, your username shows at the top of the page, in red, until you create your user page. Click on your username to do that.
  2. On your page, add some sections as given below, as it is your profile on the OpenOffice Wiki;
    • About yourself
    • OpenOffice and you
    • Your contributions
    • Work in progress
    • Any future plans?
    • Reference (optional)
    • Contact

So, this is somewhat of a template, for creating a profile. You may or may not need to follow this template, you may have sections of your choice. This is done to make a uniform profile for all the new users.

Adding Comments

Important comments should be announced on the mailing list doc@openoffice.apache.org to be sure that they get noticed.

To add a comment to a page

  1. Click the Discussion tab on the top of the page.
    • If you are starting a new topic click on the + sign to the right of the edit tab at the top, fill in the subject line and write your comment in the main text box.
    • If you want to add a comment to an existing discussion leave it after the existing comments and indent it by putting one or more colons (:) at the beginning of each paragraph.
  2. Sign your username with four tildes (~~~~). You can do this automatically with the signature with timestamp button ( button_sig.png ) on the toolbar.
  3. Click Save Page.

To learn more about comments see the Mediawiki help about talk pages

Structure of the Documentation Section of the Wiki

The Documentation section is only part of the large OpenOffice.org Wiki. The doc.oo.o project tries to present the information in this section in a way that it is easily accessible and has a structure that allows straightforward navigation for both users and contributors.

All documentation pages are subpages of the main Documentation page. A further substructure presents sections as subpages containing further subpages. Think of it as a hierarchical representation, just like a file system. Every subpage is automatically linked back to the main page.

The current wiki page tree looks like this:

Subpage Description
Documentation/Dashboard High-level tracking of documentation sub-projects and content deliverables
Documentation/Administration Guide Guide that describes how to administer an OpenOffice.org network installation
Documentation/FAQ Collection of FAQs.
Documentation/How Tos Link collection of How Tos
Documentation/OOoAuthors User Manual Collection of OpenOffice.org 2.x User Guides from OOoAuthors
Documentation/OOo3 User Guides Collection of OpenOffice.org 3 User Guides from OOoAuthors
Documentation/Tutorials Tutorial collections from different contributors
Documentation/Samples, Templates and Clipart Sub-project page in order to provide usable templates for business and personal use (draft)
Documentation/Setup Guide Sub-project page in order to provide a guide through the setup process of OpenOffice.org (in progress)
Documentation/BASIC Guide Guide that provides an introduction to programming with OpenOffice.org BASIC
Documentation/Building Guide Guide that describes how to build the Apache OpenOffice software yourself, from source.
Documentation/DevGuide Guide that describes how to program with OpenOffice.org using the component technology UNO (Universal Network Objects) with OpenOffice.org.
Documentation/Reference Collection of reference material. References on this page should show up under Reference Lists at the Documentation main page.

Creating new Pages

Documentation caution.png Before creating a page make sure that there is not already an existing page with a similar topic.
  • If the new page can be a subpage of an existing page simply go to the existing page and create a link to the new page. After saving the page with the link you can click the link and start writing on your new page.
  • If you want to create a really new page for the Documentation project, you can use the wiki's URL for creating a new page. You should observe the wiki page tree when you create a new page in this way. The URL to a wiki page is then something like this:
    http://wiki.services.openoffice.org/wiki/documentation/Page Name
  • However, the recommended method is to search for the desired page name (in the Search field above left), and when the page does not exist, you will be offered to "create this page" by clicking on a link on the Search Results Page.
Documentation note.png The URL approach is only useful if you link the page later to other pages. Otherwise it will be hidden in the wiki.

For more information about new pages see the Mediawiki help about new pages

Using Categories

The Categories that are assigned to a page are usually listed at the bottom of the page. Click on a Category, and you will view a topic page with all the pages that have been classified in that Category. This way, a Category tag in a page gives you the opportunity to look up related contents. The bigger the page the more Category tags might be inserted

To add a Category tag to a page

  1. Click Special pages in the toolbox on the left side.
  2. Click Categories in the Special pages link list.
  3. Choose a Category name that makes sense, and apply it by adding [[Category:''Category Name'']] at the end of the page.
Documentation caution.png Do not create duplicate Categories for the same topic. Each Category must be unique. Otherwise it will be difficult to use the Categories for searching the wiki.

Look at MediaWiki Help:Categories if you want to know more about Wiki Categories.

A simple example of how to use Categories in Wiki books:

  1. Create a Category named after the current chapter.
  2. Add the new Category tag to all pages of that chapter
  3. Add the Category tag for the book to the newly created Category page.

The reader can then view the book Category. The book Category shows all the chapters in the book. If the reader clicks on a chapter Category, they can see all of the pages in that chapter (in alphabetical order).

Do not add a category and its subcategory to the same wiki page. For more information see the MediaWiki Help:Category section on Category considerations.

You can use Templates to add a common category to a large group of pages, but it is not recommended. It may appear to save time, but "adding or deleting a category tag in the template does not add or delete the listings on the category page of pages that use the template, until some edit is made in the page that uses the template." For more information, see the MediaWiki Help:Category section on Using templates to populate categories.

Templates

Look at the Templates help if you are unfamiliar with mediawiki templates.

Adding a new Documentation Template

  • If you create a new template to be used in the wiki documentation, name it as a subpage of Documentation.
    • wrong: mytemplate
    • right: Documentation/mytemplate
  • Add a description of the template purpose and usage to the template itself using the element as described in MediaWiki help: Template.
  • Add the template to the list of templates below.

List of Existing Documentation Templates

This is a list of Documentation templates and their usage 
Template Name Usage Example
Template:Mt Service template for marking multilingual templates. {{Mt|EN}}

This template itself is also multilanguage.

Displays the following message:

Multilingual template

Go to the template page to view available localizations.


Template:Revision

Multilingual template

Go to the template page to view available localizations.


This template is intended to mark pages that need revision. {{Revision|EN}}

Template:DocBanner Puts the Documentation Project "Banner" at the top right of the page

{{DocBanner}}

Docbanner.png
Template:OOoLogo Displays an OpenOffice.org logo

{{OOoLogo}}

Ooo.png
Template:PDF {{PDF}} Pdf.png
Template:OOo A variable for displaying the string OpenOffice.org.

{{OOo}}

Apache OpenOffice
Template:AOo A variable for displyaing the string Apache OpenOffice

{{AOo}}

Apache OpenOffice
Template:Bar Used to draw horizontal bars for simplistic bar charts

{{Bar|100|10|#3333FF}}
{{Bar|57|10|#33FF33}}
{{Bar|112|10|#FF3333}}

Template:BeingEdited

Multilingual template

Go to the template page to view available localizations.


Marks a page as currently being edited to avoid conflicting changes. Use this template when you perform larger edits on a file that may even take more than one session to finish. Be sure to add name and date of "locking" by adding a ~~~~ as parameter: {{BeingEdited|EN|А. Е. Харламенков (talk) 10:40, 6 July 2018 (UTC)|1}}

Documentation beingedited.png This page is currently being edited Fpe 17:54, 7 February 2008 (CET)

 

Template:NeedsRework

Multilingual template

Go to the template page to view available localizations.


Marking an article to check for accuracy and consistency with the style. {{NeedsRework|EN}}

Edit-find-replace.png This article should be checked for accuracy and conformity to style.

Template:HelpNeeded

Multilingual template

Go to the template page to view available localizations.


{{HelpNeeded|EN|Check the spelling}}

Documentation needshelp.png This article needs help


Check the spelling

 

Template:Old

Multilingual template

Go to the template page to view available localizations.


Identifies a page that is obsolete {{Old|EN}}

Book-old.png    This article is outdated.    
 
Template:DraftPage

Multilingual template

Go to the template page to view available localizations.


Marks up pages that are in a draft state {{DraftPage|EN}}

Editing.png This page is in a DRAFT stage.

 

Template:CoreCriticalTemplate This template is intended to mark the Core Critical Template, unconsidered intervention in the template may result in the destruction of the entire project!

{{CoreCriticalTemplate}}

CoreCriticalTemplate.png  Критически важный опорный шаблон    —    Core Critical Template.  

Необдуманное вмешательство в шаблон может повлечь за собой разрушение всего проекта! Unconsidered intervention in the template may result in the destruction of the entire project!

 

Template:Imported

Multilingual template

Go to the template page to view available localizations.


{{Imported|EN|Author Name|Contributor Names}}

This article was imported from another document. Original author: Author Name - Previous contributors: Contributor Names
Template:Win Displays a Windows logo and allows to enter Windows specific content.

{{Win|Windows related content}}

Documentation windows.png Windows related content
Template:Lin Displays a Linux logo and allows to enter Linux specific content.

{{Lin|Linux related content}}

Documentation linux.png Linux related content
Template:Mac Displays an Apple/OSX logo and allows to enter OSX specific content

{{Mac | Mac related content}}

Documentation Mac Logo 40.png Mac related content
Template:Bug Links to Issuezilla issue.

{{Bug|123456}}

Issue 123456
Template:Note Takes sections containing notes,i.e. related, reinforcing information, for example, an explanation or comment.

{{Note|Notable stuff}}

Documentation note.png Notable stuff
Template:Tip Takes sections containing tips, i.e. useful non-crucial information, for example, a keyboard shortcut.

{{Tip|Right-click opens the context menu}}

Tip.png Right-click opens the context menu
Template:Warn Takes sections containing warnings, i.e. information that is potentially harmful in some way, for example, data loss.

{{Warn|Always switch off power before opening the case.}}

Documentation caution.png Always switch off power before opening the case.
Template:SeeAlso

Multilingual template

Go to the template page to view available localizations.


{{SeeAlso|EN|


See Also


Template:HeaderBlock Ornamental template.

Designed to process the most important links in the form of the similarity of a button. {{HeaderBlock|Documentation}}

Template:FromForum

Multilingual template

Go to the template page to view available localizations.


{{FromForum|EN}}

Contents of this article derived from the OpenOffice User Forum.

Template:Documentation/*TOC Several tables of content based on Template:Documentation/MasterTOC used in guides. See, for example, the Basic Guide TOC
Template:Documentation/MasterTOC This is the master template that is used to create tables of content. For usage click the template name.
Template:OOoVersion

Multilingual template

Go to the template page to view available localizations.


This template is used to insert an OpenOffice.org version box on a page. Multilingual templates. This template is designed to be inserted into the article notes about the version of OpenOffice.org, to which the article. {{OOoVersion|EN|1.1.x}}

Version Apache OpenOffice 1.1.x

Template:AOoVersion

Multilingual template

Go to the template page to view available localizations.


This template is used to insert an ApacheOpenOffice version box on a page. {{AOoVersion|EN|4.1.x}}

Version Apache OpenOffice 4.1.x

Template:OOoW This template is used to insert an Apache OpenOffice Writer string in text.

{{OOoW}}
{{OOoW|1}}

Apache OpenOffice Writer
Writer
Template:OOoC This template is used to insert an Apache OpenOffice Calc string in text.

{{OOoC}}
{{OOoC|1}}

Apache OpenOffice Calc
Calc
Template:OOoCh This template is used to insert an Apache OpenOffice Chart string in text.

{{OOoCh}}
{{OOoCh|1}}

Apache OpenOffice Chart
Chart
Template:OOoI This template is used to insert an Apache OpenOffice Impress string in text.

{{OOoI}}
{{OOoI|1}}

Apache OpenOffice Impress
Impress
Template:OOoD This template is used to insert an Apache OpenOffice Draw string in text.

{{OOoD}}
{{OOoD|1}}

Apache OpenOffice Draw
Draw
Template:OOoB This template is used to insert an Apache OpenOffice Base string in text.

{{OOoB}}
{{OOoB|1}}

Apache OpenOffice Base
Base
Template:OOoM This template is used to insert an Apache OpenOffice Math string in text.

{{OOoM}}
{{OOoM|1}}

Apache OpenOffice Math
Math
Template:POOo This template is used to insert an Portable OpenOffice.org

string in text. {{POOo}}

Portable OpenOffice.org
Template:SRB This template is used to insert an 'Sun Report Builder' string in text.

{{SRB}}
{{SRB|1}}

Sun Report Builder
Sun Report Builder
Template:MSO This template is used to insert an Microsoft Office string in text.

{{MSO}}

Microsoft Office
Template:MSO2003 This template is used to insert an Microsoft Office 2003 string in text.

{{MSO2003}}
{{MSO2003|1}}

Microsoft Office 2003
MSO 2003
Template:MSO2010 This template is used to insert an Microsoft Office 2010 string in text.

{{MSO2010}}
{{MSO2010|1}}

Microsoft Office 2010
MSO 2010
Template:MSW This template is used to insert an MS Word string in text.

{{MSW}}
{{MSW|1}}

MS Word
Word
Template:MSE This template is used to insert an MS Excel string in text.

{{MSE}}
{{MSE|1}}

MS Excel
Excel
Template:MSA This template is used to insert an MS Access string in text.

{{MSA}}
{{MSA|1}}

MS Access
Access
Template:MSPP This template is used to insert an MS Power Point string in text.

{{MSPP}}
{{MSPP|1}}

MS Power Point
Power Point
Template:MSEq This template is used to insert an MS Equation string in text.

{{MSEq}}
{{MSEq|1}}

MS Equation
Equation
Template:MSV This template is used to insert an MS Visio string in text.

{{MSV}}
{{MSV|1}}

MS Visio
Visio
Template:Key This template is used to insert keycodes in text.

{{Key|Ctrl|Shift|>}}

 Ctrl  +  ⇧ Shift  +  → 
Template:Button This template is used to insert an article in the notation of buttons on-screen dialogues.

{{Button|Ok}}

 Ok 
Template:QuoteEn The template is designed for inserting quotations in the text.

{{QuoteEn|quote=OpenOffice.org 3 is the leading open-source office software suite for word processing, spreadsheets, presentations, graphics, databases and more.|author=why.openoffice.org}}

Quote bg.pngOpenOffice.org 3 is the leading open-source office software suite for word processing, spreadsheets, presentations, graphics, databases and more.

why.openoffice.orgQuote bg2.png

Template:Menu This template is designed to insert text anywhere in the chain menu.

{{Menu|File|Open|Print|и т. д.}}

File → Open → Print → 4 → 5 → 6 → 7 → 8 → 9 → 10
Template:Path This template using to format file system path.

{{Path|C:\Program files\OpenOffice.org}}

C:\Program files\OpenOffice.org


Graphical Content

General guidelines for images are:

  • Use a descriptive and unique title. The filename should be constructed in a way so it shows the usage, e.g. Doc_mig_icon_data.png = Documentation image, used in the migration guide, depicting the database icon.
  • If possible, do not pre-scale the images you are uploading. You can use the MediaWiki image thumbnail feature to scale the image.
  • Edit the image if necessary to make sure that the important part is clear and visible.
  • Keep in mind that people may be translating the page where you are placing an image. Try not to include callouts or other extra text on the image.
  • JPG is usually best for photos, SVG, for icons, logos etc, and PNG for screen captures. Try not to use BMP.


Before you can insert your well prepared image in a wiki page you have to upload it.

  1. In the sidebar, under toolbox, click Upload file. The image description page will appear.
  2. Use the image description page to describe an image and copyright status (if any).


To place the image on a page you can use the MediaWiki Image thumbnail feature which "wraps" your illustrations in an image box. This image box includes a spot for an image caption. The syntax is
File:image.png
Image caption
, where:
  • thumb = thumbnail the image and wrap in an image box
  • position = position on page. "none" places the image on the left of the frame with no text wrapping. "left" and "right" places the image on the left or right of the page with full text wrapping.
  • size = max width in pixels for the image. If the image is larger than this value it is scaled down. If the image is smaller it is left as is.

If you do not declare a position and size, the image is scaled to a small thumbnail, and defaults to the right hand side of the page with full text wrapping.

Here is an example using [[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]

An example image caption
  • How to handle image and table numbering?

Linking

Although the editing window offers assistence in writing internal and external links look at the MediaWiki help page about links for a better understanding of how links are working in wikis.

There is another MediaWiki help page if you need some examples.

When creating link text consider the guidelines for using links in our style guide.

General Editing Work

Editing is only possible after login. You can start editing the whole page after clicking the edit tab at the top. But usually it is more comfortable to edit individual sections of a page by clicking one of the [edit] links on the right side. If you make changes, please consider the rules of the style guide to assure a consistent writing style. Click the Show preview button before you save the page finally.

Fixing inappropriate, inaccurate, or outdated content

Contents that are not up to date are usually marked by one of the following labels:

Book-old.png    This article is outdated.    
 
This label means that an article is outdated as a whole and needs to be revised completely.

Documentation needshelp.png This article needs help


works for OOo 2, needs to be confirmed for OOo 3

 

If an article is partly outdated or inaccurate you may find this label asking for specific help.

Edit-find-replace.png This article should be checked for accuracy and conformity to style.

You can find a collection of pages with this label if you click on Pages that Need Help! on the Wiki main page.

When you have selected a page to work on

  1. test whether the described procedures are still valid for the current version of OpenOffice.org.
  2. log in and make the necessary corrections.

This works best when you open two tabs in the browser, one for reading the procedures and another for editing.

When you have finished, remove the above label(s), mark the page with the label "Checked for technical accuracy" (as described in the Templates section above), and click Save page.

Fixing minor errors and typos

If you detect minor errors like typos, just log in and edit the article. Before clicking on the Save page button you might check the This is a minor edit box above.

Fixing graphics and screenshots

To edit a graphic in the wiki, right-click the graphic and choose Save image as. When you have edited the graphic on your computer, go back to the wiki page, click the graphic, and in the image description page choose Upload a new version of this file.

If you have created a new version of a screenshot, directly click the corresponding screenshot in the wiki and then Upload a new version of this file in the image description page.

Fixing Style and Language

Articles that need improvement in style and language might be recognized by the following labels:

Documentation needshelp.png This article needs help


Check the spelling

 


Edit-find-replace.png This article should be checked for accuracy and conformity to style.

You can find a collection of articles with the latter label if you click on Pages that Need Help! on the Wiki main page.

To improve such an article, just log in, click on the edit tab and make the necessary corrections. Then remove the label(s) and click on Save page.

Linking to localized pages

  • Link the various languages to each other using the Interwiki links syntax [[ISO_Lang_code:Page_Title]].
    For example, [[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]] adds a link to the Chinese translation of the first page of the Developer's Guide. This link shows in the left column, under the heading "In other languages". This may be more practical to do with Wiki Templates as more languages are added.
  • In the Developer's guide we use a template to link translated pages.
    The Wiki Syntax is: {{Documentation/DevGuideLanguages|Page_Title}} where Page_Title is the current Wiki page name.
    For example, {{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org Developers Guide}} will add the localized page links for the first page in the Developer's Guide.
    If you want to see a link to your language at the Developer's Guide wiki pages simply add your language to the template Template:Documentation/DevGuideLanguages. For example, for Dutch you would have to add [[nl:NL/{{{1}}}]]. Make sure the template is referenced correctly in each of the translated pages.

Validating Content

Fixing Spam / Deleting Pages

If you detect spam you can send an email to the dev@ list.

There is also a list of Wiki Sysops (people who can delete pages). If you want to have pages deleted, you can either ask someone from that list, or better, add the Wiki Syntax {{delete}} anywhere on the page you want to be deleted. This will add the page to the "Candidates for speedy deletion" category, and the page will be deleted by someone with Sysop privileges, or by WikiBot maintenance.

Working on FAQs

Every question together with its answer is displayed on one single wiki page.

If you want to insert a new FAQ entry, that is, a pair of a question together with the corresponding answer:

  1. Select a FAQ section on the main page of the Documentation Wiki. In Writer and Calc you have to select another subpage until you reach a final FAQ section.
  2. Scroll down to the Insert New FAQ listbox.
  3. Replace the text in the listbox after the last slash '/' with your question.
  4. Click Add New FAQ
    A new wiki page will be created and preloaded with a template for a Q/A pair:
    {{{DISPLAYTITLE: (INSERT FAQ TITLE)}}
     
    <section begin=question/>
    <INSERT QUESTION>
    <section end=question/>
     
    <section begin=answer/>
    <INSERT ANSWER>
    <section end=answer/>
     
    [[Category:Documentation/FAQ/<INSERT FAQ SECTION>]]
  5. Replace (INSERT FAQ TITLE) with the title of the FAQ to be displayed on the page. This may be a short version of the question or the question itself.
  6. Replace <INSERT QUESTION> with the actual question.
  7. Replace <INSERT ANSWER> with the actual answer.
  8. Replace <INSERT FAQ SECTION> with the current FAQ section name. This category assignment determines where this wiki page will appear. Please use the following section names:
  9. FAQ section section name in category
    General General
    Installation Installation
    Word Processing Writer
    Automatic Functions Writer/AutomaticFunctions
    Document Management Writer/DocumentManagement
    Formatting Pages and Docs Writer/FormattingPagesAndDocuments
    Formatting Text Writer/FormattingText
    Graphics, Frames & Objects Writer/GraphicsFramesObjects
    Indexes, Tables of Contents Writer/IndexToc
    Printing and Mail Merge Writer/Printing
    Spreadsheets Calc
    Drawings Draw
    Presentations Impress
    Formula Editor Formula
    Database Databases
    Macros Macros
  10. Click Save Page.

Working on How Tos

If you want to create a new How To

  1. Go to the How Tos section and open the edit window.
  2. Identify the adequate subsection and enter the title of your How To as a link.
  3. Click Save Page to make the link visible.
  4. Click the link to your How To and start writing by using the rules of the style guide. If you are not sure about how to implement the style guide, have a look at the Writer How To Getting a Picture Into the Gallery.
Documentation note.png Always put the licence link at the end of your article: Simply insert {{PDL1}}.

You can also create How Tos by writing a new page like Documentation/How Tos/Page Name with one or more specific categories. The newly created How To page will then be assigned to the corresponding How To sections. The available categories for that are the following:

  • [[Category:Documentation/How Tos/Installation]]
  • [[Category:Documentation/How Tos/Writer]]
  • [[Category:Documentation/How Tos/Impress]]
  • [[Category:Documentation/How Tos/Calc]]
  • [[Category:Documentation/How Tos/Database]]


If you want to revise existing How Tos, watch for the label "This article needs to be checked for accuracy and style."

  • Test whether the described procedures are still valid for the current version of OpenOffice.org,
  • check whether the rules of the style guide are applied,
  • check for grammar and spelling mistakes,

and make the necessary corrections in the edit window.

When you have finished, mark the page with the label "Checked for technical accuracy" as described in the Templates section above, and click Save page.

Do not forget to notify dev@documentation.openoffice.org about your work on the How Tos.

Working on Guides

Currently, there are the following guides on the wiki:

If you want to work on the User Guides for OpenOffice.org please contact the OOoAuthors group.

There is some help available about Contributing to the Developer's Guide which may also be useful for the Administration Guide and the BASIC Programming Guide.

Localizing Content

Here are some general guidelines for translations:

  • If possible, follow the same structure as the original page.
  • If possible, do not translate the Wiki page names. Use the {{DISPLAYTITLE:Page title}} to localize the page name. Using the same page name makes it easier to identify translated pages and easier to automatically link from one page to another
  • Use a subpage naming structure that clearly indicates the language of the page. For example, the Swedish version of a page could use SV/Pagename/. See Help:Page naming
Documentation note.png If possible, try to always use all-caps for the ISO language code.
  • Communicate with the L10N and NLC communities and let them know what you're doing.
  • If in doubt, ask. The Documentation, and NLC communities are here to help you.

The Apache OpenOffice L10N community is working on a process and toolset for translating Wiki pages.

Translation steps

There are (currently) no tools or mechanisms in place in the Wiki to assist with translations. The basic translation process is:

  1. Identify a page that is to be translated.
  2. Click Edit on that page.
  3. Select all Wiki text in that page and copy it.
  4. Cancel the edit.
  5. Start a new page with the right page name for the new translated article (see Help:Page naming).
  6. Paste in the copied original language text.
  7. Click Save Page to give yourself a start point.
  8. Translate the text on the newly created page.


Content on this page is licensed under the Public Documentation License (PDL).
Views
Personal tools
Navigation
Tools
In other languages