Loading...
 
Architecture / Installation

Architecture / Installation

Forum List Topic List

Forums » Architecture / Installation » how to get local copy of TikiWiki documentation
 
Thread actions
PDF Print this page
  • Print all pages

    • how to get local copy of TikiWiki documentation

    Posted by adt_dev posts: 5

    Hi all. I have a nice TikiWiki installation on a machine that is not on the internet. I would like to get a copy of the TikiWiki documentation (particularly end-user type of documentation/help/tutorials). I'd like to add this documentation in the form of a Wiki (kind of like mirroring a part of doc.tiki.org). The purpose is so that my local test users can get at the how-to's on this local TikiWiki site itself. When I try to search for how to do this, I get links to "how to install TikiWiki", and doc.tiki.org, which isn't what I want. I have to admit, I'm stumped. (Doing something similar for Mediawiki was fairly simple, so I'm sure it's very easy in TikiWiki too, once you know where to look!)

    I should mention that I don't need to mirror all of doc.tiki.org - I just need some basics.

    Thanks in advance for pointing me in the right direction.

    Reads: 1596
    Link
    Posted by adt_dev posts: 5
    adt_dev wrote:

    Hi all. I have a nice TikiWiki installation on a machine that is not on the internet. I would like to get a copy of the TikiWiki documentation (particularly end-user type of documentation/help/tutorials). I'd like to add this documentation in the form of a Wiki (kind of like mirroring a part of doc.tiki.org). The purpose is so that my local test users can get at the how-to's on this local TikiWiki site itself. When I try to search for how to do this, I get links to "how to install TikiWiki", and doc.tiki.org, which isn't what I want. I have to admit, I'm stumped. (Doing something similar for Mediawiki was fairly simple, so I'm sure it's very easy in TikiWiki too, once you know where to look!)

    I should mention that I don't need to mirror all of doc.tiki.org - I just need some basics.

    Thanks in advance for pointing me in the right direction.

    Link

    Posted by Marc Laporte posts: 1633 Canada

    Hi!

    We planned for that a long time ago. Which is why all the documentation links in the admin panel and in features can be changed to your local copy.

    ex. doc.tiki.org/Blogs becomes tikidocs.lan/Blogs

    However, I don't remember this happening a single time. People just use the online version to have latest version.

    We even had an automatic dump of doc.tiki.org which was stripped of data like usernames, etc. but I think it disappeared because no one was using... Maybe it's time to bring this back, but you would get all pages...

    How many pages do you have in mind?

    If it's just a few dozen, simplest is just to copy-paste source to your local instance.

    We could also make a profile (profiles.tiki.org) which would contain some of the most-used info.

    We could give you a dump of doc.tiki.org but it's huge!

    Ideally, we could have some sort of shopping cart for pages where you pick & choose what you need, export to XML and re-import back.

    Best regards,

    M ;-)

    Link
    Posted by Rick Sapir / Tiki for Smarties posts: 3665 United States

    Actually, I wonder if the Dump feature still works....

    But if you want to have a local copy of the Tiki Installation Guide and Tiki Reference Guide, you can:

    1. Use Tiki's multi-print feature to create a printer-ready structure of each book.
    2. Use your browser's Save Page As... command to save this structure as a local HTML file.
    3. Add the generated HTML file (and all associated files, images, etc.) to your web server.
    4. Link to the generated HTML file from a wiki page.


    HTH,

    - Rick | My Tiki Blog | My Tiki UserPage

    Tiki for Dummies Smarties, the best (and only) Tiki beginner's guide! Learn more...

    Tiki Essentials, the best-selling book for Tiki! Learn more...

    Need more help? Try Tiki for Dummies Smarties: A beginner's guide and Tiki Essentials: What all Smarties need to know about Tiki Wiki CMS Groupware.

    Link
    Posted by adt_dev posts: 5
    Rick Sapir / Tiki for Smarties wrote:
    Actually, I wonder if the Dump feature still works....


    Thanks for the info. I could see the "shopping cart" approach being useful. Being able to have a local copy of various documentation would be handy for sites that were not connected to the internet (as is the case for my site) or for locations where LAN traffic is fast enough but internet traffic is very slow.

    I looked at the "multprint" suggestion but it was not clear how to work with it. The closest I got was to try
    http://doc.tiki.org/tiki-print_indexed.php?list=Tiki+Reference+Guide
    for which I didn't have access rights (which makes sense).

    What I'm finding is that the thing that attracts me to TikiWiki is also a stumbling block: it has extensive capabilities, and can provide a very rich user interface, but then when trying to find simple things, it is easy to get lost in the weeds. For the community I have in mind I'd want both: the ability to provide more sophisticated capabilities, but an initial experience that is simple and uncluttered. So for my initial prototyping work I'd want to have some simple how-to pages for the initial community. As you point out, I could just build some myself.

    BTW when you say a dump of doc.tiki.org is huge, you mean multi gigabytes? Just curious.

    In the meantime, I've grabbed the Tiki Refernce Guide.odt which will suffice for the moment.

    Thanks again.

    Any

    Link
    Posted by Rick Sapir / Tiki for Smarties posts: 3665 United States
    adt_dev wrote:

    I looked at the "multprint" suggestion but it was not clear how to work with it. The closest I got was to try
    http://doc.tiki.org/tiki-print_indexed.php?list=Tiki+Reference+Guide
    for which I didn't have access rights (which makes sense).


    No, you need to use the multiprint option, then select the specific structure to print.

    http://doc.tiki.org/tiki-print_pages.php

    See the docs, for details.

    HTH,

    - Rick | My Tiki Blog | My Tiki UserPage

    Tiki for Dummies Smarties, the best (and only) Tiki beginner's guide! Learn more...

    Tiki Essentials, the best-selling book for Tiki! Learn more...

    Need more help? Try Tiki for Dummies Smarties: A beginner's guide and Tiki Essentials: What all Smarties need to know about Tiki Wiki CMS Groupware.

    Link
    Posted by adt_dev posts: 5

    Hi Rick,

    Thanks for the suggestions. I thought I was making progress but ran into some problems. What I did was this:

    click on the link:
    http://doc.tiki.org/tiki-print_pages.php

    Then log in.
    There are two tabs on the page: Structures, and Pages. Click on Pages.
    In the section, 'Add Pages from Structures",
    Select the section you want, then click on the "Add Pages from Structures". This will copy many pages into the "Selected Pages" box. Below that box, click on the "Print" button. Didn't work, got "no pages selected."
    Tried Ctrl-clicking on pages in the "selected pages" box, click print. Same thing (get "no pages selected").

    It looks like if there are "too many" pages listed in the "selected pages" box, when you hit "print", it will come back with "no pages selected". The print button works if there is one or two pages selected from the "available pages" box. I'm not sure how many pages you can add before it goes belly up, but somewhere between 3-15 or more. Could be that it hits a limit based on the size of the pages. If you "add pages from structures" (like the Tiki Reference Guide), there will be too many pages to print. If you try to remove any pages from that list, it empties the list.

    So maybe the solution, as you suggest, is abandon the idea of having a local copy and have people use the online system. The downside to that is that between our
    network and the doc.tiki.org server, pages come up pretty slowly (which is one of the reasons I was hoping to have a local copy). We do have the .odt version available, so we could just reference that.

    Marc had mentioned the concept of having some profiles of most-used pages. That would be pretty cool, particularly if this could be added to a site in the form of wikis (i.e., tiki markup language) as opposed to html.

    Thanks again for the help.

    Link
    Posted by Rick Sapir / Tiki for Smarties posts: 3665 United States

    Indeed... it looks like selecting specific pages is broken. :-(

    However, if you simply select the structure instead, it works fine (at least it just did for me!).

    HTH,

    - Rick | My Tiki Blog | My Tiki UserPage

    Tiki for Dummies Smarties, the best (and only) Tiki beginner's guide! Learn more...

    Tiki Essentials, the best-selling book for Tiki! Learn more...

    Need more help? Try Tiki for Dummies Smarties: A beginner's guide and Tiki Essentials: What all Smarties need to know about Tiki Wiki CMS Groupware.

    Link
    Posted by adt_dev posts: 5
    Rick Sapir / Tiki for Smarties wrote:

    Indeed... it looks like selecting specific pages is broken. :-(

    However, if you simply select the structure instead, it works fine (at least it just did for me!).

    HTH,

    - Rick | My Tiki Blog | My Tiki UserPage


    Hello again.
    I tried the "Add Structure" from the "Structures" tab on that page. It does present the top level page, which I can save as html, but the links on the page still refer back to the doc.tiki.org site (and from the size of the html, it is only that top page that is being saved - none of the underlying pages are saved).

    In the meantime, I've gone to the pages on doc.tiki.org that I think out initial users would be most interested in (tiki syntax pages) and I was able to capture the tiki markup source, which is very handy. I'll add these pages to our internal site.

    Thanks again!

    Link