Developer forums (C::B DEVELOPMENT STRICTLY!) > Development
Documentation in various formats
darklordsatan:
And in case there was one, what would be the default behaviour, export to...?
David Perfors:
I don't know, I was looking if it was possible to export to any (probably HTML) format.
btw. I agree that there should be images in the documentation.
Also I want to say that CVS is usefull to use, but indeed it could be very difficult to use it and not everybody is able to commit. (which is sometimes a possitive thing).
About Latex, you are right, it is difficult, there are other options... Docbook for example, it is used very much by large projects.
I am not sure if wxWidgets is supporting CHM for linux, but I thought they do.
darklordsatan:
DocBook... the one Ive never wanted to touch... from what I know, its a DTD and you implement the tags and stuff, but have no Idea on how it really works, and what are the tools to make an output... And recently I was searching for WYSIWYG editors for this format (trying to help someone at gamedev), but It seems there are not many (as in "none"); the existing solutions are apparently, crap. So we have again the problem of hand-editing wich can be time consuming and tiring for the big work we have ahead
--- Quote from: mispunt ---
I am not sure if wxWidgets is supporting CHM for linux, but I thought they do.
--- End quote ---
Now that it comes in mind, I think the samples show it does indeed. IIRC, thats one of the reasons I was so thrilled with wxwidgets (in the times of wxwindows and 2.4.2). Probably the sample "help" is the one that shows such functionality
About the wiki, what do you mean exporting to html? doesnt it suffices to save it from your browsers "save as" function, or you dont want the extra columns and stuff?
David Perfors:
With the exporting I mean exporting the articles to html.. and I mean only the text... when you have an article with many chapters all on a sepperate page you have to use a lot the "save as" function. In my opinion it should be possible to export an article with many sub pages to one format so we could use that for distribution.
About the tools, I don't know any usefull WYSIWYG editor which is usefull for us :cry: I tink it is time to write one :evil:
darklordsatan:
My question in the meantime would be then, what are the input formats in order to create a CHM that a tool X would receive?
I'd like to know the names of some "tool X"
IIRC, the utility tex2rtf in wx can generate CHMs from .tex (so goodbye). Also, NSIS uses a modified version of Halibut or something, that can create CHMs as well?
What are the other options?
(Im probably moving towards CHM in a too obvious way, but I bet most people would agree with me its the best format, and besides having a CHM is like having HTMLs, which could serve as the online docs on the way...)
Navigation
[0] Message Index
[#] Next page
[*] Previous page
Go to full version