[campsite-dev] online documentation software
  • we have been searching for some software to do the documentation for
    campware. most urgently for campsite and livesupport. please mail
    suggestions to the dev list.

    the main objectives:

    a) import and export standard formats (DocBook, HTML, RTF, PDF)
    b) multilinguality
    c) user comments for code examples (like php.net)

    what we found that looks close to what we want:
    http://doc-book.sourceforge.net/homepage/
    http://sourceforge.net/projects/doc-book/

    demo site:
    http://www.soft.inima.al/kushtetuta/

    we need a demo install to find out more. michal, can you set one up at
    campware.org?

    it uses the phpWebApp frame. so installation might be a bit troublesome.
    http://www.soft.inima.al/phpwebapp/documentation/


    Micz Flor - micz@mi.cz

    content and media development http://mi.cz
    -----------------------------------------------------------------
    http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    "I told our marketing guys to speak now or forever be silent."
    (Aleksandar Brajanoski)
    -----------------------------------------------------------------

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • 9 Comments sorted by
  • This looks good . .

    http://wiki.splitbrain.org/wiki%3Afeatures

    Sean



    Micz Flor wrote:
    > we have been searching for some software to do the documentation for
    > campware. most urgently for campsite and livesupport. please mail
    > suggestions to the dev list.
    >
    > the main objectives:
    >
    > a) import and export standard formats (DocBook, HTML, RTF, PDF)
    > b) multilinguality
    > c) user comments for code examples (like php.net)
    >
    > what we found that looks close to what we want:
    > http://doc-book.sourceforge.net/homepage/
    > http://sourceforge.net/projects/doc-book/
    >
    > demo site:
    > http://www.soft.inima.al/kushtetuta/
    >
    > we need a demo install to find out more. michal, can you set one up at
    > campware.org?
    >
    > it uses the phpWebApp frame. so installation might be a bit troublesome.
    > http://www.soft.inima.al/phpwebapp/documentation/
    >
    >
    > Micz Flor - micz@mi.cz
    >
    > content and media development http://mi.cz
    > -----------------------------------------------------------------
    > http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    > "I told our marketing guys to speak now or forever be silent."
    > (Aleksandar Brajanoski)
    > -----------------------------------------------------------------
    >
    >
    >

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • At 16:54 25.01.2005, you wrote:
    >This looks good . .
    >
    >http://wiki.splitbrain.org/wiki%3Afeatures

    we looked at that, too. but it does not support multilinguality and/or
    import export - or i missed out on something.


    >Sean
    >
    >
    >
    >Micz Flor wrote:
    >>we have been searching for some software to do the documentation for
    >>campware. most urgently for campsite and livesupport. please mail
    >>suggestions to the dev list.
    >>the main objectives:
    >>a) import and export standard formats (DocBook, HTML, RTF, PDF)
    >>b) multilinguality
    >>c) user comments for code examples (like php.net)
    >>what we found that looks close to what we want:
    >>http://doc-book.sourceforge.net/homepage/
    >>http://sourceforge.net/projects/doc-book/
    >>demo site:
    >>http://www.soft.inima.al/kushtetuta/
    >>we need a demo install to find out more. michal, can you set one up at
    >>campware.org?
    >>it uses the phpWebApp frame. so installation might be a bit troublesome.
    >>http://www.soft.inima.al/phpwebapp/documentation/
    >>
    >>Micz Flor - micz@mi.cz
    >>content and media development http://mi.cz
    >>-----------------------------------------------------------------
    >>http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    >>"I told our marketing guys to speak now or forever be silent."
    >>(Aleksandar Brajanoski)
    >>-----------------------------------------------------------------
    >>
    >


    Micz Flor - micz@mi.cz

    content and media development http://mi.cz
    -----------------------------------------------------------------
    http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    "I told our marketing guys to speak now or forever be silent."
    (Aleksandar Brajanoski)
    -----------------------------------------------------------------

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • Well the import/export might be an issue (HTML and RAW only)but it does
    say that it has Multilanguage Support


    * works on plain text files
    * simple syntax and easy editing with quickbuttons and accesskeys
    * Section Editing allows you to edit small parts of a page
    * automatic generation of content tables
    * unlimited page revisions
    * colored diff support
    * support for read only pages
    * syndication of recent changes as RSS Feed
    * namespaces
    * Interwiki Links
    * uploading and embedding images
    * image caching and resizing
    * easy navigation through breadcrumbs
    >>>>>> * Multilanguage Support
    * Spam blacklist
    * custom text replacements
    * pagecaching
    * locking to avoid edit conflicts
    * and more
    * and much more


    Sean

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • This is a multipart message in MIME format.
    --=_alternative 005C8FC9C1256F94_=
    Content-Type: text/plain; charset="us-ascii"

    My own 2 cents, which at today's exchange rate is worth 1.54 euro cents...

    Import/export is going to be a key requirement, because we are working
    with documentation writers who are turning in their work in DocBook format
    on the import side, and we'd like to be able to dump documentation either
    to a file (for help/manuals, for example, or for printing manuals). So any
    one of these tools we choose has to have this functionality.

    doug

    =============================================
    Media Development Loan Fund
    =============================================
    Douglas Arellanes
    Head of Research and Development
    Center for Advanced Media--Prague (CAMP)
    Na vinicnich horach 24a/1834, 160 00 Prague 6
    Czech Republic
    Tel: + 420 2 3333 5356, Fax: +420 2 2431 5419
    Mobile: +420 724 073 364
    http://www.mdlf-camp.net
    http://www.campware.org
    =============================================
    http://www.mdlf.org
    =============================================




    Sean Flynn
    01/25/2005 05:44 PM
    Please respond to campsite-dev


    To: campsite-dev@campware.org
    cc:
    Subject: Re: [campsite-dev] online documentation software


    Well the import/export might be an issue (HTML and RAW only)but it does
    say that it has Multilanguage Support


    * works on plain text files
    * simple syntax and easy editing with quickbuttons and accesskeys
    * Section Editing allows you to edit small parts of a page
    * automatic generation of content tables
    * unlimited page revisions
    * colored diff support
    * support for read only pages
    * syndication of recent changes as RSS Feed
    * namespaces
    * Interwiki Links
    * uploading and embedding images
    * image caching and resizing
    * easy navigation through breadcrumbs
    >>>>>> * Multilanguage Support
    * Spam blacklist
    * custom text replacements
    * pagecaching
    * locking to avoid edit conflicts
    * and more
    * and much more


    Sean




    --=_alternative 005C8FC9C1256F94_=
    Content-Type: text/html; charset="us-ascii"



    My own 2 cents, which at today's exchange rate is worth 1.54 euro cents...



    Import/export is going to be a key requirement, because we are working with documentation writers who are turning in their work in DocBook format on the import side, and we'd like to be able to dump documentation either to a file (for help/manuals, for example, or for printing manuals). So any one of these tools we choose has to have this functionality.



    doug



    =============================================

    Media Development Loan Fund

    =============================================

    Douglas Arellanes

    Head of Research and Development

    Center for Advanced Media--Prague (CAMP)

    Na vinicnich horach 24a/1834, 160 00  Prague 6

    Czech Republic

    Tel: + 420 2 3333 5356, Fax: +420 2 2431 5419

    Mobile: +420 724 073 364

    http://www.mdlf-camp.net

    http://www.campware.org

    =============================================

    http://www.mdlf.org

    =============================================










    Sean Flynn <sflynn@tec-man.com>

    01/25/2005 05:44 PM

    Please respond to campsite-dev


           

            To:        campsite-dev@campware.org

            cc:        

            Subject:        Re: [campsite-dev] online documentation software






    Well the import/export might be an issue (HTML and RAW only)but it does

    say that it has Multilanguage Support





        * works on plain text files

        * simple syntax and easy editing with quickbuttons and accesskeys

        * Section Editing allows you to edit small parts of a page

        * automatic generation of content tables

        * unlimited page revisions

        * colored diff support

        * support for read only pages

        * syndication of recent changes as RSS Feed

        * namespaces

        * Interwiki Links

        * uploading and embedding images

        * image caching and resizing

        * easy navigation through breadcrumbs

    >>>>>>    * Multilanguage Support

        * Spam blacklist

        * custom text replacements

        * pagecaching

        * locking to avoid edit conflicts

        * and more

        * and much more





    Sean








    --=_alternative 005C8FC9C1256F94_=--

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • See this: http://wiki.splitbrain.org/wiki:multilanguage

    --- Micz Flor wrote:

    > At 16:54 25.01.2005, you wrote:
    > >This looks good . .
    > >
    > >http://wiki.splitbrain.org/wiki%3Afeatures
    >
    > we looked at that, too. but it does not support multilinguality and/or
    > import export - or i missed out on something.
    >
    >
    > >Sean
    > >
    > >
    > >
    > >Micz Flor wrote:
    > >>we have been searching for some software to do the documentation for
    > >>campware. most urgently for campsite and livesupport. please mail
    > >>suggestions to the dev list.
    > >>the main objectives:
    > >>a) import and export standard formats (DocBook, HTML, RTF, PDF)
    > >>b) multilinguality
    > >>c) user comments for code examples (like php.net)
    > >>what we found that looks close to what we want:
    > >>http://doc-book.sourceforge.net/homepage/
    > >>http://sourceforge.net/projects/doc-book/
    > >>demo site:
    > >>http://www.soft.inima.al/kushtetuta/
    > >>we need a demo install to find out more. michal, can you set one up at
    > >>campware.org?
    > >>it uses the phpWebApp frame. so installation might be a bit troublesome.
    > >>http://www.soft.inima.al/phpwebapp/documentation/
    > >>
    > >>Micz Flor - micz@mi.cz
    > >>content and media development http://mi.cz
    > >>-----------------------------------------------------------------
    > >>http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    > >>"I told our marketing guys to speak now or forever be silent."
    > >>(Aleksandar Brajanoski)
    > >>-----------------------------------------------------------------
    > >>
    > >
    >
    >
    > Micz Flor - micz@mi.cz
    >
    > content and media development http://mi.cz
    > -----------------------------------------------------------------
    > http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    > "I told our marketing guys to speak now or forever be silent."
    > (Aleksandar Brajanoski)
    > -----------------------------------------------------------------
    >
    >


    __________________________________________________
    Do You Yahoo!?
    Tired of spam? Yahoo! Mail has the best spam protection around
    http://mail.yahoo.com

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • but this only translates the interface and there are links for different
    source codes. but not the content itself. or did i miss something?

    At 19:40 25.01.2005, you wrote:
    >See this: http://wiki.splitbrain.org/wiki:multilanguage
    >
    >--- Micz Flor wrote:
    >
    > > At 16:54 25.01.2005, you wrote:
    > > >This looks good . .
    > > >
    > > >http://wiki.splitbrain.org/wiki%3Afeatures
    > >
    > > we looked at that, too. but it does not support multilinguality and/or
    > > import export - or i missed out on something.
    > >
    > >
    > > >Sean
    > > >
    > > >
    > > >
    > > >Micz Flor wrote:
    > > >>we have been searching for some software to do the documentation for
    > > >>campware. most urgently for campsite and livesupport. please mail
    > > >>suggestions to the dev list.
    > > >>the main objectives:
    > > >>a) import and export standard formats (DocBook, HTML, RTF, PDF)
    > > >>b) multilinguality
    > > >>c) user comments for code examples (like php.net)
    > > >>what we found that looks close to what we want:
    > > >>http://doc-book.sourceforge.net/homepage/
    > > >>http://sourceforge.net/projects/doc-book/
    > > >>demo site:
    > > >>http://www.soft.inima.al/kushtetuta/
    > > >>we need a demo install to find out more. michal, can you set one up at
    > > >>campware.org?
    > > >>it uses the phpWebApp frame. so installation might be a bit troublesome.
    > > >>http://www.soft.inima.al/phpwebapp/documentation/
    > > >>
    > > >>Micz Flor - micz@mi.cz
    > > >>content and media development http://mi.cz
    > > >>-----------------------------------------------------------------
    > > >>http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    > > >>"I told our marketing guys to speak now or forever be silent."
    > > >>(Aleksandar Brajanoski)
    > > >>-----------------------------------------------------------------
    > > >>
    > > >
    > >
    > >
    > > Micz Flor - micz@mi.cz
    > >
    > > content and media development http://mi.cz
    > > -----------------------------------------------------------------
    > > http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    > > "I told our marketing guys to speak now or forever be silent."
    > > (Aleksandar Brajanoski)
    > > -----------------------------------------------------------------
    > >
    > >
    >
    >
    >__________________________________________________
    >Do You Yahoo!?
    >Tired of spam? Yahoo! Mail has the best spam protection around
    >http://mail.yahoo.com


    Micz Flor - micz@mi.cz

    content and media development http://mi.cz
    -----------------------------------------------------------------
    http://www.campware.org -- http://crash.mi.cz -- http://sue.mi.cz
    "Das kommt in beiden Faellen Blau. Von Lila keine Spur."
    (Heike Bruysten)
    -----------------------------------------------------------------

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • Have a read of the fantastic php.net documentation. I think that the
    ability to have users annotate documentation is a really big plus.

    http://cvs.php.net/co.php/livedocs/README?r=1.14
    http://www.php.net/manual/en/about.generate.php

    JP

    Douglas.Arellanes@mdlf.org wrote:

    >
    > My own 2 cents, which at today's exchange rate is worth 1.54 euro
    > cents...
    >
    > Import/export is going to be a key requirement, because we are working
    > with documentation writers who are turning in their work in DocBook
    > format on the import side, and we'd like to be able to dump
    > documentation either to a file (for help/manuals, for example, or for
    > printing manuals). So any one of these tools we choose has to have
    > this functionality.
    >
    > doug
    >
    > =============================================
    > Media Development Loan Fund
    > =============================================
    > Douglas Arellanes
    > Head of Research and Development
    > Center for Advanced Media--Prague (CAMP)
    > Na vinicnich horach 24a/1834, 160 00 Prague 6
    > Czech Republic
    > Tel: + 420 2 3333 5356, Fax: +420 2 2431 5419
    > Mobile: +420 724 073 364
    > http://www.mdlf-camp.net
    > http://www.campware.org
    > =============================================
    > http://www.mdlf.org
    > =============================================
    >
    >
    >
    > *Sean Flynn *
    >
    > 01/25/2005 05:44 PM
    > Please respond to campsite-dev
    >
    >
    > To: campsite-dev@campware.org
    > cc:
    > Subject: Re: [campsite-dev] online documentation software
    >
    >
    >
    >
    > Well the import/export might be an issue (HTML and RAW only)but it does
    > say that it has Multilanguage Support
    >
    >
    > * works on plain text files
    > * simple syntax and easy editing with quickbuttons and accesskeys
    > * Section Editing allows you to edit small parts of a page
    > * automatic generation of content tables
    > * unlimited page revisions
    > * colored diff support
    > * support for read only pages
    > * syndication of recent changes as RSS Feed
    > * namespaces
    > * Interwiki Links
    > * uploading and embedding images
    > * image caching and resizing
    > * easy navigation through breadcrumbs
    > >>>>>> * Multilanguage Support
    > * Spam blacklist
    > * custom text replacements
    > * pagecaching
    > * locking to avoid edit conflicts
    > * and more
    > * and much more
    >
    >
    > Sean
    >
    >
    >

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • yes. that is what we are looking for. can we have exactly what php.net is?
    under GPL or LGPL or PHP license? if yes, case closed.

    At 02:13 26.01.2005, you wrote:
    >Have a read of the fantastic php.net documentation. I think that the
    >ability to have users annotate documentation is a really big plus.
    >
    >http://cvs.php.net/co.php/livedocs/README?r=1.14
    >http://www.php.net/manual/en/about.generate.php
    >
    >JP
    >
    >Douglas.Arellanes@mdlf.org wrote:
    >
    >>
    >>My own 2 cents, which at today's exchange rate is worth 1.54 euro cents...
    >>
    >>Import/export is going to be a key requirement, because we are working
    >>with documentation writers who are turning in their work in DocBook
    >>format on the import side, and we'd like to be able to dump documentation
    >>either to a file (for help/manuals, for example, or for printing
    >>manuals). So any one of these tools we choose has to have this functionality.
    >>
    >>doug
    >>
    >>=============================================
    >>Media Development Loan Fund
    >>=============================================
    >>Douglas Arellanes
    >>Head of Research and Development
    >>Center for Advanced Media--Prague (CAMP)
    >>Na vinicnich horach 24a/1834, 160 00 Prague 6
    >>Czech Republic
    >>Tel: + 420 2 3333 5356, Fax: +420 2 2431 5419
    >>Mobile: +420 724 073 364
    >>http://www.mdlf-camp.net
    >>http://www.campware.org
    >>=============================================
    >>http://www.mdlf.org
    >>=============================================
    >>
    >>
    >>
    >> *Sean Flynn *
    >>
    >>01/25/2005 05:44 PM
    >>Please respond to campsite-dev
    >>
    >>
    >> To: campsite-dev@campware.org
    >> cc:
    >> Subject: Re: [campsite-dev] online documentation software
    >>
    >>
    >>
    >>
    >>Well the import/export might be an issue (HTML and RAW only)but it does
    >>say that it has Multilanguage Support
    >>
    >>
    >> * works on plain text files
    >> * simple syntax and easy editing with quickbuttons and accesskeys
    >> * Section Editing allows you to edit small parts of a page
    >> * automatic generation of content tables
    >> * unlimited page revisions
    >> * colored diff support
    >> * support for read only pages
    >> * syndication of recent changes as RSS Feed
    >> * namespaces
    >> * Interwiki Links
    >> * uploading and embedding images
    >> * image caching and resizing
    >> * easy navigation through breadcrumbs
    >> >>>>>> * Multilanguage Support
    >> * Spam blacklist
    >> * custom text replacements
    >> * pagecaching
    >> * locking to avoid edit conflicts
    >> * and more
    >> * and much more
    >>
    >>
    >>Sean
    >>
    >>


    Micz Flor - micz@mi.cz

    content and media development http://mi.cz
    -----------------------------------------------------------------
    http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    "I told our marketing guys to speak now or forever be silent."
    (Aleksandar Brajanoski)
    -----------------------------------------------------------------

    ------------------------------------------
    Posted to Phorum via PhorumMail
  • So, what is our documentation tool going to be? Let's resume the
    discussion.

    Sava



    Micz Flor
    > cc:
    Sent by: Subject: Re: [campsite-dev] online documentation software
    micz.flor@web.de


    01/26/05 10:55 AM
    Please respond to
    campsite-dev






    yes. that is what we are looking for. can we have exactly what php.net is?
    under GPL or LGPL or PHP license? if yes, case closed.

    At 02:13 26.01.2005, you wrote:
    >Have a read of the fantastic php.net documentation. I think that the
    >ability to have users annotate documentation is a really big plus.
    >
    >http://cvs.php.net/co.php/livedocs/README?r=1.14
    >http://www.php.net/manual/en/about.generate.php
    >
    >JP
    >
    >Douglas.Arellanes@mdlf.org wrote:
    >
    >>
    >>My own 2 cents, which at today's exchange rate is worth 1.54 euro
    cents...
    >>
    >>Import/export is going to be a key requirement, because we are working
    >>with documentation writers who are turning in their work in DocBook
    >>format on the import side, and we'd like to be able to dump documentation

    >>either to a file (for help/manuals, for example, or for printing
    >>manuals). So any one of these tools we choose has to have this
    functionality.
    >>
    >>doug
    >>
    >>=============================================
    >>Media Development Loan Fund
    >>=============================================
    >>Douglas Arellanes
    >>Head of Research and Development
    >>Center for Advanced Media--Prague (CAMP)
    >>Na vinicnich horach 24a/1834, 160 00 Prague 6
    >>Czech Republic
    >>Tel: + 420 2 3333 5356, Fax: +420 2 2431 5419
    >>Mobile: +420 724 073 364
    >>http://www.mdlf-camp.net
    >>http://www.campware.org
    >>=============================================
    >>http://www.mdlf.org
    >>=============================================
    >>
    >>
    >>
    >> *Sean Flynn *
    >>
    >>01/25/2005 05:44 PM
    >>Please respond to campsite-dev
    >>
    >>
    >> To: campsite-dev@campware.org
    >> cc:
    >> Subject: Re: [campsite-dev] online documentation software
    >>
    >>
    >>
    >>
    >>Well the import/export might be an issue (HTML and RAW only)but it does
    >>say that it has Multilanguage Support
    >>
    >>
    >> * works on plain text files
    >> * simple syntax and easy editing with quickbuttons and accesskeys
    >> * Section Editing allows you to edit small parts of a page
    >> * automatic generation of content tables
    >> * unlimited page revisions
    >> * colored diff support
    >> * support for read only pages
    >> * syndication of recent changes as RSS Feed
    >> * namespaces
    >> * Interwiki Links
    >> * uploading and embedding images
    >> * image caching and resizing
    >> * easy navigation through breadcrumbs
    >> >>>>>> * Multilanguage Support
    >> * Spam blacklist
    >> * custom text replacements
    >> * pagecaching
    >> * locking to avoid edit conflicts
    >> * and more
    >> * and much more
    >>
    >>
    >>Sean
    >>
    >>


    Micz Flor - micz@mi.cz

    content and media development http://mi.cz
    -----------------------------------------------------------------
    http://www.campware.org -- http://crash.mi.cz -- http://suemi.de
    "I told our marketing guys to speak now or forever be silent."
    (Aleksandar Brajanoski)
    -----------------------------------------------------------------

    ------------------------------------------
    Posted to Phorum via PhorumMail