# Difference between revisions of "GeoGebra Manual:Village Pump"

This is our little local village pump (inspired by Wikipedia). This place is intended for discussions about the GeoGebraWiki itself. If you want to contribute more to this wiki than adding examples and comments, please add your project idea to the list below for discussions or let us know what you are working on. If you need to change a lot of pages for your idea please contact Florian Sonner – there might be a more simple solution.

## Wiki Structure

Please read or at least skim through the following pages if you want to help us. The listed pages contain vital information which help you understand the internal structure of this wiki.
• Project description – a forum post which contains an introduction why this project has been started
• Official MediaWiki Help Document – describes the functionality and idea of a wiki and the commands you can use to edit a page
• GeoGebraWiki Structure – describes the structure of this wiki (e.g. the namespaces used)
• Manual Structure – describes the special structure of the manual and the reasons behind this
• How To – instructions how to perform certain common tasks

How to organize the knowledge about GeoGebra? Write down your ideas and let it discuss by the community!

## Village-Pump-Workers

Who wants to help? Tell about you knowledge and write down you ideas at your user-page and add your name to the following list

## Projects

### Manual

Just tool and command pages were transferred from the old manual until now, but the manual consists of a lot more which has to be transferred. Before transferring the content we also have to think about a way to organize the content in a more wiki-like way. --Florian Sonner 16:52, 18 May 2010 (UTC)

As I already mentioned somewhere: In my opinion there are more kind of keywords necessary like:
• Object ...
• Property ... exemple: the name of an object
• View ... names for "visible" parts, not only the main parts like graficview, algebraview, ... but for little parts like columns, rows and cell, too
Hope it is not too late, but the pagenames Category:Tools would be better readable, if the "Tool" is in brackets: Angle Tool -> Angle (Tool).
--Birgit Lachner
• not sure what you mean by "keywords". Categories? Use of categories should be automatized via the infoboxes.
• renaming articles
1. maybe too late
2. generally it's better to have as few non-letters in URL as possible

--Kondr 23:09, 18 June 2010 (UTC)

Yes I ment Categories. In the last months a lot was changed. Seems to be on a good way! If I could help to do some slavery-work for you ... like adding the templates (note, exemple, ...) ... call me. --Birgit Lachner 07:24, 31 August 2010 (UTC)
Contributions are always welcome! :) We already have Template:Note and Template:Example but not all command / tool pages use them, it would be great if you could add them to these pages if necessary. --Florian Sonner 22:12, 31 August 2010 (UTC)
If there is interest, you can use an adaptation of a gadget from Portuguese Wikibooks (made in JavaScript and jQuery), to simplify the titles of items in "Tools" and "Commands" categories without needing to rename the pages themselves. It would be something like this:
if ( 'Category' === wgCanonicalNamespace && $.inArray( wgTitle, [ 'Tools', 'Commands' ] ) > -1 ) {$(function () {
var regexForCats = new RegExp(wgTitle + '?$','g');$('#mw-pages a').each(function (index) {
\$(this).html(function(i, old) {
return old.replace(regexForCats, '');
});
});
});
}

This could be either added to the site js, using MediaWiki:Common.js (or to some gadget so that users can enable/disable it on Special:Preferences as they like).
PS: I wasn't able to test it here since wgAllowUserJs seems to be set to false in this wiki, but the code seems to be correct. Helder 20:43, 16 April 2011 (CEST)

### Changelog

We should start a changelog which contains information about changed commands and tools, so that documentation can be changed easily on new release. No sense to do it now, but will be useful for 4.0 -> 4.2 transition.

Since there hasn't been any changelog till now, please look at Category:Outdated, pick a page, make sure it's compatible with 4.0 and set version parameter of Template:Manual Page to either 3.2 or 4.0, depending on whether the content of that page has changed between 3.2 and 4.0 manuals.

### Reference

• XML guide: Reference:Xml contains complete XML reference. In the future it would be nice to have a short tutorial on that page, since the auto-generated articles are not exactly easy to read.

### Multi-language sidekicks

I guess we could

• start Interwiki
• use version parameter to show some "outdated infobox" + outdated category if version of sideḱick article is older than English one
• prepare a script, which generates Command and Tool pages from 3.2 manual including cross-language link to English original (I guess the English ones were generated by such script), set version of all auto-generated pages to 3.2
• in each sidekick create a "translation progress" page which contains mapping of English -> non-English article mapping + some info about outdated pages
• to Talk of each non-tool & non-command page add something like "translation start point" pointing to appropriate current help node

Translation would work like this:

• user looks at the "translation progress" page and picks an untranslated article
• creates translation, sets version to match English version
• once all pages are translated, user looks at "outdated" list ad picks an article
• creates translation, sets version to match English version
• once all articles are created, one has to set their order in the book. May be done by bots, but user assistance would help.
• if user is not capable of using wiki properly, she can add some "cleanup required" template and someone with more wiki skills will help.

## Templates

Info templates

see Project:Village Pump/Infobox for details

• Tools (Manual) -- done
• Commands(Manual)
• GUI (Manual) -- done
• Objects (Manual)
• Events
• Tutorials
• GeoGebra Institute

Markup templates

• example
• note
• ggb and ggt templates from old wiki

... and a short guide on how and when these should be used

## Wanted extensions

• math (discussed at Admin's talk)