i-net-software / dokuwiki-plugin-siteexport

DokuWiki plugin to export pages or namespaces to static html
https://www.dokuwiki.org/plugin:siteexport
GNU General Public License v2.0
24 stars 12 forks source link

How to give Windows write permissions. #133

Open rgleason opened 4 months ago

rgleason commented 4 months ago

When running on Windows xammp + dokuwiki. OR. dokuwikistick with apache server on the c drive user directory, how should we confrim or set write permissions for the files and directories needed to run siteexport.

To be clear, this discussion is only for locally installed dokuwiki on a windows 10 or 11 computer, with a private network protected by a router from the internet. The wiki files have been downloaded from the website and have been installed on the local machine in under the dokuwiki directory, and the wiki has been configured with necessary plugins and settings so that it runs properly and can be edited and managed.

One problem is Windows uses a different system for permissions than dokuwiki and apache with php.

Another problem is we don't know how to determine the group, user and pw that apache is using, so that we can make those write permissions.

The third thing that is unclear, is exactly how to go about setting those permissions. Is it done under the Windows Properties system, or under some linux/apache system? What commands and paths are used?

Also refer to this Dokuwiki Permissions page

rgleason commented 4 months ago

The first step is to see if you can export a PDF, using the lower right menu. The next step is to see if you can export a HTML file using the lower right menu. I believe if those are working your folder permissions are ok.

rgleason commented 4 months ago

Regarding "Siteexport Downloading" Signs of a missing configuration.

Should end with "Sitexport Finished"

  1. Check permissions of directories https://www.dokuwiki.org/permissions

  2. Under Admin Configuration find SiteExport and see what this is set to

    plugin»siteexport»zipfilename Wiki Path and name for exported ZIP file

    On the website version I have now changed it to

    opencpn:siteexport:siteexport.zip from opencpn:wiki:siteexport:sitexport.zip

  3. Now when I try to save one page with siteexport it shows as "SiteExport Downloading"

    These directories and files need to exist!

    The only way I can create a new directory under media is by using FileZilla FTP, so I do that.

    Using Filezilla, browse to: ..\dokuwiki\data\media\opencpn and make a new directory

    ..\dokuwiki\data\media\opencpn\siteexport

    Next we need to use Media Manager to upload an old version of siteexport.zip to that directory.

    The file siteexport.zip needs to exist in the Config location plugin»siteexport»zipfilename

Now try to download a single page using siteexport.

 Message should be "SiteExport finished"

And a siteexport file should be downloaded and open in your file browser.
rgleason commented 4 months ago

Myron's suggestion about giving permissions for a local installation , by making a folder with the permissions under apache and copying the dokuwiki files into that.

https://forum.dokuwiki.org/d/16168-local-server-bitunami-dokuwiki-stack-user-error-edited-config-dokuwiki-php/6

At the time I was using bitunami