View Issue Details
|ID||Project||Category||View Status||Date Submitted||Last Update|
|0003622||Scribus||Documentation||public||2006-04-10 22:03||2016-12-06 15:06|
|Target Version||1.6 milestone|
|Summary||0003622: Allow Scribus to search for additional directories for docs|
|Description||In current versions of Scribus, additional docs like Niyam's tutorial have to be copied into the "tutorials" directory to be found by the help browser. It would be fine to enable the use of other directories as well. That way, different versions of Scribus could share a set of docs, provided, the menu.xml file is in the docs' directory.|
I'm all for it, it should be easier to install additional docs. Two proposals:
1. An additional setting in the Prefs, where users could define the "Additional docs" directory to be searched for tutorials.
2. Scribus should search $home/.scribus/tutorials for additional docs.
In both cases, Scribus could use the current mechanism of searching the subdirectories for menu.xml. Craig?
||And system wide directory as a third option/addition: usr/share/doc/scribus|
||What about Win32?|
>>What about Win32?
They have their $home/.scribus too, or at least sth similar :)
||I know ;) I was thinking of the system wide directory for docs. "All Users"?|
||Greg, what are your thoughts on this? Especially given r20688 (btw, thank you for that :)|
This is tricky when you consider the various OSes, and different levels of user skills.
The ability to use the Scribus manual from a browser, that I have added to 1.5.1svn may be a bridge. It shows people how to access the manual from their own browser, and consequently, they can access their own custom docs/pages in the same way.
Let me experiment with the idea of putting a placekeeper HTML doc inside .scribus to see if we might have a way to access this from menu.xml. It would still then require users to add to the placekeeper their own links.
||gpittman, how did the experiment workout ?|
It's a bit of a secret, or perhaps forgotten information, that inside the source docs there is a file, scribus-manual.xsl, which along with some modifications of menu.xml (which are already in place) allows anyone to access the manual from any browser.
All you have to do is point your browser to pathtoScribus/doc/en/menu.xml, and you have full access to the manual without ever running Scribus.
Since this file isn't included in the instructions for copying, it's only in source code for now.
I don't know if anyone else sees the utility in this, but it may be one avenue to pursue and develop. I think we're waiting for the final decisions to be made about where the docs will go.
|2006-04-10 22:03||christoph_s||New Issue|
|2006-04-11 08:52||mhanski||Relationship added||related to 0000830|
|2006-04-11 08:55||mhanski||Additional Information Updated|
|2006-05-09 19:25||mhanski||Note Added: 0011175|
|2006-05-09 19:26||mhanski||Status||new => feedback|
|2006-05-09 19:32||christoph_s||Note Added: 0011176|
|2006-05-09 19:33||christoph_s||Note Added: 0011177|
|2006-05-09 19:36||mhanski||Note Added: 0011178|
|2006-05-09 19:40||christoph_s||Note Added: 0011179|
|2014-08-21 11:39||Kunda||Tag Attached: easyhack|
|2014-10-15 17:07||Kunda||Tag Renamed||easyhack => #easyhack|
|2016-01-19 12:23||Kunda||Note Added: 0038266|
|2016-01-20 15:29||gpittman||Note Added: 0038306|
|2016-03-07 13:42||Kunda||Note Added: 0039024|
|2016-12-06 13:19||Kunda||Note Added: 0042720|
|2016-12-06 14:33||gpittman||Note Added: 0042721|
|2016-12-06 15:06||Kunda||Target Version||=> 1.6 milestone|
|2016-12-06 15:06||Kunda||Patch||=> No|