View Issue Details

IDProjectCategoryView StatusLast Update
0003622ScribusDocumentationpublic2016-12-06 15:06
Reporterchristoph_s Assigned To 
PrioritynormalSeverityfeatureReproducibilityalways
Status feedbackResolutionopen 
PlatformallOSallOS Versionall
Product Version1.3.4cvs 
Target Version1.6 milestone 
Summary0003622: Allow Scribus to search for additional directories for docs
DescriptionIn 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.
Additional Informationhttp://wiki.scribus.net/index.php/Including_3rd_party_documentation_into_Scribus_help_browser
Tags#easyhack
PatchNo

Relationships

related to 0000830 closedcbradney Integration of 3rd party docs within Scribus 

Activities

mhanski

2006-05-09 19:25

developer   ~0011175

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.

or

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?

christoph_s

2006-05-09 19:32

developer   ~0011176

And system wide directory as a third option/addition: usr/share/doc/scribus

christoph_s

2006-05-09 19:33

developer   ~0011177

What about Win32?

mhanski

2006-05-09 19:36

developer   ~0011178

>>What about Win32?

They have their $home/.scribus too, or at least sth similar :)

christoph_s

2006-05-09 19:40

developer   ~0011179

I know ;) I was thinking of the system wide directory for docs. "All Users"?

Kunda

2016-01-19 12:23

updater   ~0038266

Greg, what are your thoughts on this? Especially given r20688 (btw, thank you for that :)

gpittman

2016-01-20 15:29

developer   ~0038306

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.

Kunda

2016-03-07 13:42

updater   ~0039024

gpittman, how did the experiment workout ?

Kunda

2016-12-06 13:19

updater   ~0042720

@gpittman ping

gpittman

2016-12-06 14:33

developer   ~0042721

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.

Issue History

Date Modified Username Field Change
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