Difference between revisions of "GeoGebra Manual:HowTo"

From GeoGebra Manual
Jump to: navigation, search
Line 1: Line 1:
This page contains instructions how to perform common task in this wiki. '''If you are searching for tutorials and instructions for GeoGebra itself, please visit the [[Tutorial:Main Page|Tutorial section]].'''
+
{{attention|This page contains instructions how to perform common task in this wiki. '''If you are searching for tutorials and instructions for GeoGebra itself, please visit the [[Tutorial:Main Page|Tutorial section]].'''}}
  
== How to add a new command ==
+
GeoGebra manual consists of two components
  
As said above all command-pages actually consists of two pages. To add a new -official- command to the wiki it's hence necessary to create two pages.  
+
;Manual namespace:Official manual pages that are meant for translation. Their content is created by several users and supervised by developers. You need to ask for the right to edit these pages at [[Talk:Village Pump]].
 +
;Public space manual:Anybody can contribute to this manual. The Manual namespace page is included into the public one, so all official information is both. Source of each such page begins with <nowiki><!-- DO NOT EDIT -->{{:Manual:{{PAGENAME}}}}<!-- END: DO NOT EDIT --></nowiki>.
  
=== Create the official-version page ===
+
{{example|There is page [[Manual:New Point Tool]], which is included into [[New Point Tool]].
# Create a new page called "Manual:NAME Command". NAME is a placeholder for the name of the command, for e.g. the circle command page will be called "Manual:Circle Command".  
+
== Roadmap ==
# It's recommended to use an existing page like [[Manual:Circle Command]] as a starting point for your own command-page, so copy the source into your new page. The wiki [http://en.wikipedia.org/wiki/Help:List#List_basics definition-list syntax] is used to list the different versions of one command.  
+
# Everybody is wellcome to contribute to the public space manual
# This page will contain the official manual and should be blocked by an administrator after creation.
+
# Some volunteers for manual namespace are also wellcome.
 
+
== How to contribute to public space manual ==
=== Create the public page ===
+
# You will need account on this wiki. There is no way to transfer accounts from old wiki.
# Now create a new page called "NAME Command". This page will later be used by the users to view the command's definition and to add own comments, tips, etc.
+
# Make sure that your planned contribution is specific for one command / feature. Otherwise consider creating a [[tutorial]].
# The text below can be used as a starting point for this page.
+
# Use the Edit link of page you want to edit.
# Save this page and the command should automatically be added to the list of commands visible in [[:Category:Commands|this category]].
+
# To make wiki more usable, use [[Help:Link|links]] where it is suitable.
 
+
# For writing your contribution use the wiki syntax (see [[Help:Contents]]) and suitable templates. Please have a look at
Copy the starting point for the public page:
+
[[:Category:Markup templates]].
 
+
# If you think that some content is badly formated, written in poor English, worth deleting/merging and you don't have time or skill to fix it, please use suitable [[:Category:Message templates]] to inform about it. Don't use the generic mbox template.
<nowiki><!-- DO NOT EDIT -->{{:Manual:{{PAGENAME}}}}<!-- END: DO NOT EDIT --></nowiki><br /><br />
+
==How to contribute to manual namespace==
<nowiki>[[Category:Commands]]</nowiki>
+
# Ask at [[Talk:Village Pump]] for the rights.
 +
# Use the conventions mentioned for the public space
 +
# Each Manual namespace page has an [[:Category:Info template|info template]]. Before editing the template inclusion please read the template's documentation (you shouldn't need to do it though).
 +
# If you want some changes to be done in info templates themselves, use talk page of that template.
 +
# For now the most important task is going through all the pages in [[:Category:Outdated]], making sure they don't miss any important information and tagging them with suitable version -- i.e. if you edit the page so that it's nicely formatted and
 +
compatible with GG 3.2, add parameter "version=3.2" to the Manual Page template. If you are sure the page is 4.0 compatible, add "version=4.0" there.

Revision as of 00:00, 31 January 2011


GeoGebra manual consists of two components

Manual namespace
Official manual pages that are meant for translation. Their content is created by several users and supervised by developers. You need to ask for the right to edit these pages at Talk:Village Pump.
Public space manual
Anybody can contribute to this manual. The Manual namespace page is included into the public one, so all official information is both. Source of each such page begins with <!-- DO NOT EDIT -->{{:Manual:{{PAGENAME}}}}<!-- END: DO NOT EDIT -->.

{{example|There is page Manual:New Point Tool, which is included into New Point Tool.

Roadmap

  1. Everybody is wellcome to contribute to the public space manual
  2. Some volunteers for manual namespace are also wellcome.

How to contribute to public space manual

  1. You will need account on this wiki. There is no way to transfer accounts from old wiki.
  2. Make sure that your planned contribution is specific for one command / feature. Otherwise consider creating a tutorial.
  3. Use the Edit link of page you want to edit.
  4. To make wiki more usable, use links where it is suitable.
  5. For writing your contribution use the wiki syntax (see Help:Contents) and suitable templates. Please have a look at

Category:Markup templates.

  1. If you think that some content is badly formated, written in poor English, worth deleting/merging and you don't have time or skill to fix it, please use suitable Category:Message templates to inform about it. Don't use the generic mbox template.

How to contribute to manual namespace

  1. Ask at Talk:Village Pump for the rights.
  2. Use the conventions mentioned for the public space
  3. Each Manual namespace page has an info template. Before editing the template inclusion please read the template's documentation (you shouldn't need to do it though).
  4. If you want some changes to be done in info templates themselves, use talk page of that template.
  5. For now the most important task is going through all the pages in Category:Outdated, making sure they don't miss any important information and tagging them with suitable version -- i.e. if you edit the page so that it's nicely formatted and

compatible with GG 3.2, add parameter "version=3.2" to the Manual Page template. If you are sure the page is 4.0 compatible, add "version=4.0" there.

© 2020 International GeoGebra Institute