Geocaching & GPS location based games

Hallo!

Gibt es vielleicht jemand von den Nutzern, die sich der Dokumentation annehmen mögen?

Im Moment liegt die Doku im SVN, also hier: http://svn.berlios.de/wsvn/cachewolf/tr ... _CacheWolf Doku_

Der Entwickler (BilboWolf), der damit angefangen hat, meldet sich leider seit längerer Zeit nicht mehr. Deswegen brauchen wir 2 Sachen:

1. Jemand, der herausfindet, wie man aus den .xml-Dateien eine Doku macht (als .hmtl, als PDF und/oder als Wiki)

2. Wenn das klar ist, muss die Doku fertig gestellt werden. Dabei könnten dann auch andere noch helfen.
Sprich: nicht einer muss alles machen)

Wer mag sich darum kümmern?

Gruß,
Pfeffer.

_________________
Dokumentation mit FAQ zum CacheWolf (Paperless Geocaching): http://www.cachewolf.de/wiki/pmwiki.php

Das ganze scheint ja im DocBook-Format vorzuliegen... eine URL, die ich über Wiki gefunden habe, ermöglicht angeblich die Konvertierung in html oder pdf
http://www.xml-dev.com/blog/test.php

Hier gibt es eine Liste von Tools, die zur Erzeugung lesbarer Dateien genutzt werden können
http://wiki.docbook.org/topic/DocBookPublishingTools

Bei Gelegenheit werde ich mal ausprobieren, ob ich aus den Dateien aus dem SVN eine Doku in pdf erzeugen kann.

ich habe mal ein bißchen gegoogelt: wenn ich das richtig sehe, dann ist gibt es einen Wiki, der direkt dieses Format verwendet und dass die Änderungen gleich in ein CVS schreibt. http://doc-book.sourceforge.net/homepage/

- Aber erstmal müssen wir es überhaupt hinbekommen, diese .xml zu einer Doku zu machen.

Gruß,
Pfeffer.

_________________
Dokumentation mit FAQ zum CacheWolf (Paperless Geocaching): http://www.cachewolf.de/wiki/pmwiki.php

also... nach stundenlangem Suchen und Testen habe ich leider nicht viel mehr als eine html-Version der Doku erstellt
Die Erzeugung eines pdf-Dokuments über xmlto scheitert bei mir noch daran, dass PassiveTex nicht gefunden wird... die manuelle Erzeugung scheitert im nächsten Schritt dann an irgendwelchen falschen Formaten in den vorliegenden xml-Dateien.

Ich habe daher jetzt mal mit "xmlto html CacheWolf Dokumentation.xml" die Html-Version erzeugt und mittels Adobe das Ganze auch noch in pdf gedruckt (leider kann ich das Ganze hier nicht hochladen, weil die Dateien zu groß sind )

Wenn jemand eine Idee hat, wie ich meinem Debian klar mache, dass PassiveTex doch installiert ist oder sich mit fo-Dateien und pdfxmltex auskennt, darf er gern Bescheid sagen


Nachtrag: Mit dem Tool "Fop" funktioniert die Erstellung eines pdf-Dokuments einigermaßen problemlos (soll heißen, es kommt ein pdf raus, auch wenn jede Menge warnings ausgegeben werden)
http://xmlgraphics.apache.org/fop/

Kann ich im SVN irgendwo die pdf-Datei einchecken? Das pdf hat leider ca. 5 MB, so dass ich es hier nicht hochladen kann.

Und noch ein Nachtrag... Bilbowolf war anscheinend so schlau, den von ihm benutzten Editor direkt im SVN abzulegen (http://svn.berlios.de/wsvn/cachewolf/tr ... =1423&sc=1)... leider habe ich einige Tage gebraucht, um genau das festzustellen

Mit dem Editor muss man sich nicht mit den DocBook-Interna rumschlagen, sondern kann schön Inhalte hinzufügen... nur der Export in pdf klappt damit leider auch nicht, da diese etwas veraltete Version nicht mit dem aktuellen fop_processor zusammenarbeiten will.

Dennoch könnte mit diesem Editor _JEDER_ mithelfen, die Doku weiter voran zu treiben

Ich werde versuchen, mir in den nächsten Tagen mal ein wenig Zeit zu nehmen und die bestehende Doku durchzuschauen... aufgrund meiner wenigen Freizeit dürft ihr da aber keine Hexerei erwarten... Hilfe wird also dankend angenommen

Es ist aber nicht sinnvoll, wenn jetzt mehrere von oben her die Doku überarbeiten. Das muss schon organisiert und aufgeteilt werden. Ich werde diese Organisation allerdings *nicht* übernehmen.

_________________
Ciao, MiK

Cachewolf-Homepage | Nightly Builds

1. besser es wird oben angefangen als gar nicht.
2. am besten wäre natürlich es würde Koordiniert. - wer macht's - und wer lässt sich koordinieren?
3. Wenn jeder einfach irgendwo anfängt, dann ist's besser als wenn jeder vorne anfängt.

Aber am wichtigsten: wie kann man überhaupt was ändern?
Läuft der Editor in Windows und in Linux? - Eine installationsanleitung für den Editor wäre super und vordringlich.

Gruß,
Pfeffer.

_________________
Dokumentation mit FAQ zum CacheWolf (Paperless Geocaching): http://www.cachewolf.de/wiki/pmwiki.php

Installation unter Windows ist ziemlich einfach: Entpacken und die exe-Datei ausführen

Unter Linux kann ich morgen mal ausprobieren.

Für die Koordination würde ich mich zur Verfügung stellen... wenn ihr mir nachseht, dass ich mal ein wenig länger brauche, um zu antworten, darf mir gern jeder per PM oder hier im Thread mitteilen, wenn er mithelfen möchte und was er gern tun würde. Ich werde dann versuchen, das so zu verteilen, dass nichts doppelt gemacht wird... ich würde mich dann auch um das Mergen der verschiedenen Versionen kümmern.

ahh - cool - das geht echt einfach.
die Zip-Datei habe ich in C.\programme entpackt und dann in dem Verzeichnis entweder direct xxe.exe oder xxe.bat doppelklicken. Danach auf datei öffnen und "CacheWolf Dokumentation.xml" öffnen.
Das sieht echt super aus in dem Editor.
Um das Dokument zu bearbeiten muss man den Cursor an die Stelle setzen, die man editieren möchte und dann "/Edit/Document Reference/Edit referenced text" aufrufen. Dann öffnet der Editor automatisch die richtige xml und man kann wunderbar WYSISIG editieren

Gruß,
Pfeffer.

_________________
Dokumentation mit FAQ zum CacheWolf (Paperless Geocaching): http://www.cachewolf.de/wiki/pmwiki.php

Jetzt kann jeder mitmachen, hier die Anleitung:

A) TourtoiseSVN herunterladen und installieren, danach:
I. Die Dokumentation herunterladen:
1. neues Verzeichnis erstellen, in dem die Dateien der Dokumentation liegen sollen
2. rechte Maustaste, Tourtoise check out wähen,

eingeben -> ok -> die Daten werden heruntergeladen


II. Die Doukemntation bearbeten:
1. Den Editor herunterladen hier http://svn.berlios.de/wsvn/cachewolf/tr ... =1423&sc=1 und in C:\programme\ (oder sonstwo) entpacken
2. den Editor starten durch Doppelklick auf C:\Programme\XMLmind_XML_Editor\bin\xxe.bat
3. die Dokumentation öffnen (Datei "CacheWolf Dokumentation.xml")
4. Die Doukmentation bearbeiten, dazu auf "/Edit/Document Reference/Edit referenced text" klicken
5. speichern

III. Die Änderungen ins Internet schieben
1. mit dem Windows-Datei-Explorer das Verzeichnis öffnen, in dem die CacheWolf-Dokumentation liegt
2. mit rechter Maustaste "SVN Commit..." auswählen
3. Eine kurze Bemerkung schreiben, was man geändert hat. Die Bemerkung sollte immer beginnen mit "Manual-de: <nick in diesem Forum>: "
4. press "ok".
5. Es kommt eine Fehlermeldung "error validating server certificate..." klick auf "Accept permanantly"
6. danach wird nach username und Passwort gefragt, gib dort "cw-manual" / XXX ein. XXX verrate ich, per PN.

IV. fertig!

Wenn man später weiter an der Dokumentation arbeiten will, dann öffnet man im Windows-Datei-Explorer das Verzeichnis, in dem die Dokumentation liegt und klickt irgendwo im leeren mit der rechten Maustaste und wählt "SVN Update". Dann werden alle Änderungen heruntergeladen, die andere in der Zwischenzeit an der Doku vorgenommen haben. Danach einfach wie unter II.2. beschreiben weiter arbeiten.

Oder soll ich das Passwort auch hier veröffentlichen? ich habe dem User cw-manual nur für die Doukemntation schreibrechte gegeben. - Eigentlich spricht nichts dagegen, oder?

Gruß,
Pfeffer.

_________________
Dokumentation mit FAQ zum CacheWolf (Paperless Geocaching): http://www.cachewolf.de/wiki/pmwiki.php