GeoGebra Manual:HowTo

From GeoGebra Manual
Jump to: navigation, search


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 GeoGebraWiki_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:Point Tool, which is included into Point Tool.

Roadmap

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

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.
  6. 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 GeoGebraWiki_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. Categories in which the page belongs are given by the Info template. Please see documentation of each template for details.
  5. If you want some changes to be done in info templates themselves, use talk page of that template.
  6. Missing pages are listed in Category:Unfinished (4.0)

Common Problems

LaTeX

LaTeX code containing {{ or }} is not working in some situations (e.g. in examples or notes). Make sure you leave a space between two consecutive braces of the same type to avoid this problem.

{{example|before <math>\sqrt{\frac{\sqrt{x^2} }{2} }</math> after}} gives

Example: before \sqrt{\frac{\sqrt{x^2} }{2} } after

while {{example|before <math>\sqrt{\frac{\sqrt{x^2}}{2}}</math> after}} doesn't work. Another solution is to replace { with &#123; and } with &#125;.

Outdated category listings, missing page reports etc.

If you create the public page of Wiki manual first and the manual page after, you have to edit the public page once more (just edit + save, not necessary to do any changes) to ensure the page appears in category given by the used template. Also if you fix broken link in Manual or Template namespace, it may still appear on list of broken links until you edit all pages that use given template / manual page. In case it is matter of one or two pages, please do this "empty edit" yourself. If multiple pages are affected, plese describe the problem to Bot or contact the administrators.

© 2024 International GeoGebra Institute