Web sites for docteam

[David Giard]

Could it be possible to use DocBookWiki? http://doc-book.sourceforge.net/

Description from Freshmeat.net:
DocBookWiki can display and edit DocBook documents online. It can 
display several documents at once (a list of books), and each of them 
can be in several languages. Editing can be done in several modes (like 
text, HTML, XML, etc.), but the basic format is always DocBook (XML). 
Each document can be converted automatically into other formats for 
downloading. All the history of modifications is kept in CVS, and any 
previous versions of a document can be recovered.

I think it would be a lot more easy for translation in the wiki.. And 
also more easy for the user, they will probably only need to select 
there language first.

However this is still in beta, but maybe we can find some developpers 
that would like to help complete this project(DocBookWiki)?



Sean Wheller wrote:
> On Thursday 02 June 2005 15:39, Henrik Nilsen Omma wrote:
> 
>>Sean Wheller wrote:
>>
>>>You have been volunteered to resolve the following infrastructure
>>>requirement to be run on host: 82.211.81.159 (the machine where our svn
>>>is currently situated.)
>>>
>>>:-)
>>>
>>> 
>>
>>Right, I'll speak with James about what the is best way of implementing
>>this. I think help.ubuntu.com should be integrated with the main site,
>>so that there is no doubt that is is official Ubuntu documentation, so
>>it will have to have the headers and tabs used here:
>>http://www.ubuntu.com/.
> 
> 
> Not sure you will need to integrate it. What we will be developing is a full 
> web-based application. With multiple books available. Trying to run it under 
> another web-app will just complicate it and fear losing screen real-estate to 
> functions that are not a part of the help system.
> 
> The same application will be installed and deployed with the distro. Hmmm, 
> actually perhaps this will make help.ubuntu.com rather redundant. The 
> difference is that on help.ubuntu you will have all documents in all 
> languages and google based search, whereas on the distro we will only install 
> key docs and eachlang will be in a separate lang pack (well that's what I am 
> asked to believe). Example of a doc that will not be packaged is the 
> Installation Guide. No need once you have the product installed. Maybe it is 
> just good to have them all there. Not sure.
> 
> 
>>>Please note that as translations arrive they will be added to svn and also
>>>moved to docteam.ubuntu and/or help.ubuntu.
>>
>>So, what should the URL structure look like?
>>help.ubuntu.com/en/breezy/topic ? I think the URL structure on the
>>docteam.ubuntu site should mirror that on help.ubuntu exactly for
>>simplicity, but there should be a notice saying 'work in progress' and
>>no fancy headers.
> 
> 
> Basically all we need is that there is a default 
> http://help.ubuntu.com/index.html. The folders etc. we will build and link to 
> from the index.html. But I think we will have the release name as the root 
> for each document set. The same will happen with docteam.ubuntu.com but as 
> you say we will have notification that this is WIP. See attached PNG for idea 
> of help app layout.
> 
> Neither of these sites are editable via the web. Editing process will look as 
> follows:
> 						
> 
> author		author						<-
>    |			|							reviewer
>   V			V								|
> wiki -> port -> docbook -> svn -> auto night build -> docteam.ubuntu.com 
> 											|
> 											V
> 									       Release Date Build
> 											|
> 											V
> 								scp docteam.ubuntu.com help.ubuntu.com
> 
> The base files will be X/HTML. What I planned is to use the basic file set 
> used in a Windows CHM. Just this time we will not be compiling them into a 
> CHM and we will be using CSS and jscript in the backend for look and 
> interactive functionality.
> 
> Thoughts, ideas etc. all welcome.
> 
> 
> 
> ------------------------------------------------------------------------
>