Difference between revisions of "GeoGebra Manual:Village Pump"

From GeoGebra Manual
Jump to: navigation, search
(+script to simplify the titles of pages in some "Tools" and "Commands" categories)
 
(18 intermediate revisions by 8 users not shown)
Line 8: Line 8:
 
* [[Project:Structure#Manual|Manual Structure]] – describes the special structure of the manual and the reasons behind this
 
* [[Project:Structure#Manual|Manual Structure]] – describes the special structure of the manual and the reasons behind this
 
* [[Project:HowTo|How To]] – instructions how to perform certain common tasks
 
* [[Project:HowTo|How To]] – instructions how to perform certain common tasks
 +
* [[Project:Translation|Translation]] - instructions for translators
  
 
How to organize the knowledge about GeoGebra? Write down your ideas and let it discuss by the community!
 
How to organize the knowledge about GeoGebra? Write down your ideas and let it discuss by the community!
Line 17: Line 18:
 
* [[User:Birgit Lachner]]
 
* [[User:Birgit Lachner]]
 
* [[User:Mathmum]]
 
* [[User:Mathmum]]
 +
* [[User:Spanish1|Usuaria:Liliana Saidon Spanish1]]
 +
* [[User:Jtico]]
 +
* [[:es:User:Juanpserrano|Juan Pablo Serrano Echeverría]]
 +
* [[User:Fleecy]]
  
 
== Projects ==
 
== Projects ==
 
===Manual===
 
===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. --[[User:Florian Sonner|Florian Sonner]] 16:52, 18 May 2010 (UTC)
+
Manual for version 4.0 is [[Manual:Main Page|ready]], manual for 4.2 is in progress. Command pages for new commands will be generated.
 
 
::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''
 
::*Menu ... ''mainmenu, submenu and commands there''
 
::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)'''.
 
::--[[User:Birgit Lachner|Birgit Lachner]]
 
<div style="margin-left:3em">
 
* not sure what you mean by "keywords". Categories? Use of categories should be automatized via the infoboxes.
 
* renaming articles
 
*# maybe too late
 
*# generally it's better to have as few non-letters in URL as possible
 
--[[User:Kondr|Kondr]] 23:09, 18 June 2010 (UTC)
 
</div>
 
::::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. --[[User:Birgit Lachner|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. --[[User:Florian Sonner|Florian Sonner]] 22:12, 31 August 2010 (UTC)
 
:::If there is interest, you can use an adaptation of [https://secure.wikimedia.org/wikibooks/pt/wiki/MediaWiki:Gadget-Títulos_simples.js a gadget from Portuguese Wikibooks] (made in JavaScript and [http://wiki.geogebra.org/skins/common/jquery.js 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:
 
<pre>
 
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, '');
 
});
 
});
 
});
 
}
 
</pre>
 
:::This could be either added to the site js, using [[MediaWiki:Common.js]] (or to some [http://www.mediawiki.org/wiki/Extension:Gadgets gadget] so that users can enable/disable it on [[Special:Preferences]] as they like).
 
:::PS: I wasn't able to test it here since [http://www.mediawiki.org/wiki/Manual:$wgAllowUserJs wgAllowUserJs] seems to be set to false in this wiki, but the code seems to be correct. [[User:Helder.wiki|Helder]] 20:43, 16 April 2011 (CEST)
 
  
 
===Changelog===
 
===Changelog===
Line 62: Line 35:
 
* XML guide: [[Reference:Xml]] contains complete XML reference. In the future it would be nice to have a short tutorial on [[Reference:Xml|that page]], since the auto-generated articles are not exactly easy to read.  
 
* XML guide: [[Reference:Xml]] contains complete XML reference. In the future it would be nice to have a short tutorial on [[Reference:Xml|that page]], since the auto-generated articles are not exactly easy to read.  
  
===Multi-language sidekicks===
+
===Italian Wiki===
I guess we could
+
[[GeoGebraWiki_talk:Italian_Wiki|Here]] there's the Italian Wiki todo list, mainly dedicated to IT translators.  
* start Interwiki
+
But this is also a page intended to contain a list of all possible changes to the GGB Official English Manual, compiled "live" when we find inconsistencies between the Wiki and the software.
* 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
 
* adds cross-language link to English article
 
* 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==
 
==Templates==
Line 101: Line 59:
  
 
==Wanted extensions==
 
==Wanted extensions==
* math (discussed at [[User talk:Florian Sonner|Admin's talk]])
+
If you think we could use an extension that is not [[Special:Version|already installed]], let us know.
* Liquid threads [[mw:Extension:LiquidThreads]]
 
* ImageMap [[Extension:ImageMap]] -- not much use cases, but may be nice
 

Latest revision as of 17:44, 27 September 2014

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

Attention.png

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.

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

Manual for version 4.0 is ready, manual for 4.2 is in progress. Command pages for new commands will be generated.

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.

Italian Wiki

Here there's the Italian Wiki todo list, mainly dedicated to IT translators. But this is also a page intended to contain a list of all possible changes to the GGB Official English Manual, compiled "live" when we find inconsistencies between the Wiki and the software.

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

If you think we could use an extension that is not already installed, let us know.

© 2024 International GeoGebra Institute