source:
trunk/doc/api/trac_wiki_api.rst
| Last change on this file was 15547, checked in by , 7 years ago | |
|---|---|
|
|
| File size: 1.8 KB | |
:mod:`trac.wiki.api` -- The Wiki API
.. module :: trac.wiki.api
Interfaces
The wiki module presents several possibilities of extension, for interacting with the Wiki application and also for extending the Wiki syntax.
First, components can be notified of the changes happening in the wiki.
.. autoclass :: trac.wiki.api.IWikiChangeListener :members: See also :extensionpoints:`trac.wiki.api.IWikiChangeListener`.
Components can also interfere with the changes, before or after they're made.
.. autoclass :: trac.wiki.api.IWikiPageManipulator :members: See also :extensionpoints:`trac.wiki.api.IWikiPageManipulator`.
Then, the Wiki syntax itself can be extended. The first and less intrusive way is to provide new Wiki macros or Wiki processors. Those are basically the same thing, as they're implemented using the following interface. The difference comes from the invocation syntax used in the Wiki markup, which manifests itself in the args parameter of :meth:`IWikiMacroProvider.expand_macro`.
.. autoclass :: trac.wiki.api.IWikiMacroProvider :members: See also `~trac.wiki.macros.WikiMacroBase` and :teo:`wiki/WikiMacros#DevelopingCustomMacros` and :extensionpoints:`trac.wiki.api.IWikiMacroProvider`.
The Wiki syntax can also be extended by introducing new markup.
.. autoclass :: trac.wiki.api.IWikiSyntaxProvider :members: See also :teo:`wiki:TracDev/IWikiSyntaxProviderExample` and :extensionpoints:`trac.wiki.api.IWikiSyntaxProvider`.
The Wiki System
The wiki system provide an access to all the pages.
.. autoclass :: trac.wiki.api.WikiSystem :members: :exclude-members: get_resource_description, resource_exists
Other Functions
.. autofunction :: parse_args
.. autofunction :: validate_page_name
