projects Plugin

SECURITY WARNING: There is a huge security risk enabling this plugin on an publicly editable wiki, just as enabling the php embedding in wiki pages, i.e., it is equivalent of opening up access to the user and group that the apache process is running with. To mitigate this risk, you need to restrict the editing privilege to only trusted user to the ”:projects” namespace.

The newest version is 2011-11-24, which is compatible with DokuWiki 2011-11-10, “Angua RC1”. See the changelog below.

Installation instructions:

• Install the plugin using the Plugin Manager and the download URL above, which points to the latest version of the plugin. Refer to Plugins on how to install plugins manually.
• Then create a ”:projects” namespace.
• Any page under the ”:projects” namespace and its sub-namepaces are managed by projects wiki.
• Restrict editing access to the ”:projects” namespace to trusted users only.

See the development page:

• See documentation for a tutorial.
• See projects wiki development page for an example, which self hosts the projects plugin.

Basic syntax:

• Declaring a page as a file with the page name as file name: <project-file type=“TYPE”/>
  • TYPE can be one of
    • source
    • generated
    • crosslink
• Dependency: <use name=“some file name”/>
• The content of a source file: <source>whatever content you want to put here</content>
• The recipe for a generated file: <recipe>some unix sh shell commands to generate a file</recipe>

The presentation of a file in a project can be customized using the style.css file.

See http://rsv.math.uvic.ca/dokuwiki/doku.php/development.

If you would like to contribute to the development, please email Junling Ma.

• 2011-11-24:
  • A simple fix for 2011-11-10 (Angua RC).

• 2011-08-07:
  • Fixed a typo in action.php that prevents processing the creation of a subproject.

• 2011-05-17:
  • Feature: now it is possible to specify which syntax to use for highlighting for the file, or a specific content/recipe block. See the documentation for details.
  • Bug fix: On the project management page, the remake and delete buttons acted on the current page, not the file next to it.

• 2011-05-14:
  • Fixed a bug that prevented the renaming of dependencies.
  • Fixed a bug that caused fatal error when a page does not have a project-file tag but uses other tags such as use, content, and recipe.

• 2011-05-11:
  • More fixes to metadata handling. This should solve the problem that the file and wiki page are out of sync bug introduced in 2011-04-29 version.

• 2011-05-10:
  • More adaptation to Rincewind RC2: The INFO global variable is gone?

• 2011-04-29:
  • Adapted to Rincewind RC1: fixed metadata usage in metadata rendering in syntax plugins.

• 2011-04-28:
  • Fixed a bug that prevent the display of file with missing dependencies.

• 2011-03-07:
  • Fixed the horrendous bug that all the buttons on the manage_files page are still using the old theme of commands.
  • use the correct php script on rsv.math.uvic.ca to check for new versions.

• 2011-02-25:
  • Display a notice for the admin when a new version is available.
  • Managing files in a project are now handled by a “manage_files” action, instead of using the admin menu. This makes users without admin privileges to be able to manage files in a project.
  • Editing buttons are no longer shown only if the user has respective permission.
  • The project file pages are not cached. This fixes any caching issue it could have been there.
  • Removed the leading and trailing empty line (one the first line).
  • Remake, create a file, create a subprojects, rebuild a project, and clean a project are now all events (remake, create, create_subproject, rebuild, clean, respectively)
  • Fixed an off-by-one bug in adding and removing the use tag.

• 2011-01-28:
  • Initial release

Please post your comments and suggestions, bug reports, etc, here.

• conflicts with plugin bookcreator: pictures (PNGs / JPGs) are generated within the projects directory, but don't show up in wiki.
• “clear project” function can delete whole wiki: restrict access of the plugin to certain configured namespaces.

• thanks for this AMAZING plugin!!
• Further Development idea:
  check for (new / updated) files of a certain filetype (scripts) in project directory and display them as sources page in wiki.