Onotoa: Simply create your Topic Maps schemas
The 1.2 version is due out fairly soon.
Onotoa assists in the construction of topic map schemas (constraint schemas).
It provides a graphic representation of types and constraints for a topic map.
You probably want to read Creating a topic map ontology with Onotoa before you try the Onotoa Handbook.
I am not sure the Onotoa Handbook, even if it were available in editable form (say ODF?), would be worth the effort to make an editorial pass at it.
Suspect splitting it into a reference manual and a users manual would be a step in the right direction. Then do an editorial pass.
Hi Patrick,
The manual has been written with asciidoc and is in the google code repository. I would appreciate a review very much.
The code is at: http://code.google.com/a/eclipselabs.org/p/onotoa/source/browse/onotoa.documentation/
Best regards
Comment by Hannes — January 26, 2011 @ 2:24 pm
Thanks!
No promises but I may try to take a look at it.
Comment by Patrick Durusau — January 26, 2011 @ 3:15 pm
Apologies, I came back to this and discovered “asciidoc” isn’t on a default version of Ubuntu.
Let me know when the documentation is in a standard editable format and I will try to take a pass at it.
Using rare or odd formats is a good way to isolate your documentation from contributions and/or review.
Comment by Patrick Durusau — January 26, 2011 @ 7:15 pm
You don’t need asciidoc in your system, just ant.
Edit the files using your favorite text editor and call in the console and it will build the html. All needed libraries are in the documentation project.
if you want to create a pdf use: ant docbook.pdf
for epub: ant docbook.pdf
regards
Hannes
Comment by Hannes — January 27, 2011 @ 6:57 am
Sigh, it isn’t a question of having asciidoc on my system, easy enough to install.
The problem is that editing requires more than simply correcting prose. It also involves knowing the syntax for production of the text.
For example, look at getting_started.txt I see:
“=== The Website of the _Onotoa_ Project ===
The _Onotoa_ project maintains a website which provides you with all> you
information about the ongoing developments.
The website is available at http://onotoa.topicmapslab.de. In <
can see a screenshot of the Onotoa website.
.Website of the _Onotoa_ project
[[website]]
[caption=”Figure:”]
image::images/onotoa_website.png[scaledwidth=”100%”]”
If this were in some standard format, like TeX, LaTeX, DocBook, ODF, etc., I would not have to guess at what impact my changes would have on the output.
I have neither the time nor interest in asciidoc to experiment with it.
Should I find the time, I will output the original text to XHTML and import it into ODF. Then I have change tracking, etc.
Comment by Patrick Durusau — January 27, 2011 @ 7:37 am
[…] This post was mentioned on Twitter by Topic Maps Lab, Félix Averlant. Félix Averlant said: http://bit.ly/ijtgn2 (Onotoa: Simply create your Topic Maps schemas) […]
Pingback by Tweets that mention Onotoa: Simply create your Topic Maps schemas « Another Word For It -- Topsy.com — January 27, 2011 @ 3:24 pm