Not logged in. · Lost password · Register
Forum: General Help and Support General Stuff RSS
need help with a use case
Avatar
Magnyz #1
Member for 2 weeks · 4 posts · Location: Stockholm, Sweden
Group memberships: Members
Show profile · Link to this post
Subject: need help with a use case
Hi,
I am contemplating moving a traditional help system, for a desktop application, online and I think maybe the wiki format would work. We have 2000+ html pages that describes various functions in the application. Before studying the manual for dokuwiki in detail I hope I can ask some basic questions here.
1. obviously adding all pages one by one manually is not feasible. What alternatives do I have to add the content in bulk?
2. can dokuwiki live on a wordpress site (using divi) or is it better (necessary?) to have it in a subdomain?
Thanks.
Avatar
schplurtz (Moderator) #2
Member since Nov 2009 · 364 posts · Location: France, Finistère
Group memberships: Global Moderators, Members
Show profile · Link to this post
Hi,

Depending on your html page, it may be possible to use one of the techniques described on tips:htmltowiki.
Once you have all your wiki files, you can drop them in dokuwiki data/pages directory and drop the various media in data/media directory. Then use the searchindex plugin to rebuild DokuWiki internal searchindex.

I don't know what divi is... But, if you have access to your webserver configuration, everything is possible (I don't know how exactly though). For example, you may have wordpress in http://example.com and DokuWiki in http://example.com/docs
Avatar
Magnyz #3
Member for 2 weeks · 4 posts · Location: Stockholm, Sweden
Group memberships: Members
Show profile · Link to this post
Ok, since my html pages are very basic hopefully then it is possible. Can you elaborate a little on how it works with folders and categories. Our current help system displays the html files in a "folder" structure (but files on disk are all in one flat folder structure) and attach categories to them for search purposes. How can I get this "meta-info" into dokuwiki so that the files are grouped appropriately?

BTW, divi is just a wordpress theme with a page builder ... and works less well with various plugins.
Thanks.
Avatar
cziehr #4
Member since Jan 2011 · 512 posts · Location: 10119 Berlin
Group memberships: Members
Show profile · Link to this post
DokuWiki doesn't provide a system for categories out of the box.

One solution is to use folders (called "namespaces" in DokuWiki), another to install the tag-plugin and create categories in this way.

It is also possible to mix using namespaces and the tag-plugin.
Avatar
Magnyz #5
Member for 2 weeks · 4 posts · Location: Stockholm, Sweden
Group memberships: Members
Show profile · Link to this post
Sounds good so far. If I put the files in a folder structure on disk, dokuwiki will interpret the folder names as namespaces and the wiki will  display the the topics grouped this way automatically? Is that how it works? Can the folder structure have any depth?

Regarding tags; are these mainly for searching or is there for example a view where I can see all topics for a certain tag?

Thanks.
Avatar
schplurtz (Moderator) #6
Member since Nov 2009 · 364 posts · Location: France, Finistère
Group memberships: Global Moderators, Members
Show profile · Link to this post
Quote by Magnyz:
Sounds good so far. If I put the files in a folder structure on disk, dokuwiki will interpret the folder names as namespaces
Yes. One thing good to know : names for everything, pages, namespace, media, must be lowercase. See https://www.dokuwiki.org/pagename .

and the wiki will  display the the topics grouped this way automatically? Is that how it works?
Not quite. by default, a wiki does not list all the available pages. wether in a namespace or not. Do you expect large wikis such as wikipedia to list all their pages ? If you need a per namespace index, you manually create a startpage for the namespace. That startpage can, automatically with a special syntax, or manually, list  the content of the namespace. Manual listing can be something good, see for example https://www.dokuwiki.org/development .  Many plugins provide some kind of index functionnality, and I think DW itself has one syntax for this too but I just don't remember.

Can the folder structure have any depth?
no depth limit, except what is acceptable for a human beeing.

Regarding tags; are these mainly for searching or is there for example a view where I can see all topics for a certain tag?
I don't know for searching. But if you want to see all topics for a given tag, that's possible. For example, to see all topics that have the "orthographe" tag on Ubuntu French DokuWiki, check https://doc.ubuntu-fr.org/?do=showtag&tag=orthographe.
Avatar
Magnyz #7
Member for 2 weeks · 4 posts · Location: Stockholm, Sweden
Group memberships: Members
Show profile · Link to this post
Thanks guys. I think I know enough to give it a test.
Avatar
MartinR #8
Member since Jul 2015 · 120 posts · Location: UK
Group memberships: Members
Show profile · Link to this post
The IndexMenu plugin will list al the pages in a namespace for you with clickable links.  See https://www.dokuwiki.org/plugin:indexmenu
Close Smaller – Larger + Reply to this post:
Verification code: VeriCode Please enter the word from the image into the text field below. (Type the letters only, lower case is okay.)
Smileys: :-) ;-) :-D :-p :blush: :cool: :rolleyes: :huh: :-/ <_< :-( :'( :#: :scared: 8-( :nuts: :-O
Special characters:
Go to forum
Imprint
This board is powered by the Unclassified NewsBoard software, 20150713-dev, © 2003-2015 by Yves Goergen
Current time: 2019-02-16, 16:45:46 (UTC +01:00)