Pmwiki-mode

<< Cookbook.EmacsPmWikiMode | Pages | Introduction >>


About pmwiki-mode for Emacs

pmwiki-mode is an Emacs-mode that allows you to edit wiki pages belonging to a wiki wiki web. Here are some of the features of pmwiki-mode:

  • Opening pages
  • Editing pages
    • Syntax highlighting of PmWiki markup.
    • Search the site from within Emacs.
  • Saving pages
    • Pages are saved (uploaded) directly back to the wiki wiki web.
    • Pages can be saved under a different name, or to a different site.
    • Pages can be renamed
  • Browsing
    • From within Emacs, make a browser (re)load the current page.
    • From within a browser, make Emacs load a page for editing.

Thus you can use the browser for browsing, and Emacs for editing, just as <insert deity> intended...

Background and brief history

pmwiki-mode was written by Christian Ridderström for working with the Lyx wiki-wiki, where LyX is a WYSIWYM document processor (What You See Is What You Mean).

pmwiki-mode was originally based on another Emacs mode, called SimpleWikiEditMode [emacswiki.org], that enables you to edit pages from the Emacs wiki-wiki [emacswiki.org] from within in Emacs.

Description of pmwiki-mode (from doing describe-mode in Emacs)

Mode to edit PmWiki pages. Typically you start by using the function `pmwiki-open' to open a URL, e.g.

        http://www.pmichaud.com/wiki/Main/HomePage

Alternatively, the same page can be opened with `pmichaud-open' by giving 'Main.HomePage' or 'Main/HomePage' as argument. Similarly, a page at the LyX wiki can be opened using `lyx-open'.

Once a page has been opened, you can edit it and then save it using `pmwiki-save' or `pmwiki-save-as'. The latter function allows you to save the page with a new name, and even to a different wiki wiki web by giving an URL as argument.

To view the wiki page that you are editing in a browser, first save it and then use the command `pmwiki-browse'.

While editing the page, you can use `pmwiki-next' and `pmwiki-prev' to quickly go to the next and previous links. And when the point is on a link, you can use `pmwiki-follow to goto the page that the link points to, i.e. that page is opened in a new buffer.

Interactive functions:

 `pmwiki-open'    - Open wiki page specified by group/name or URL
 `pmwiki-next'    - Goto the next WikiWord or free link?.
 `pmwiki-prev'    - Goto the previous WikiWord or free link?.
 `pmwiki-follow'  - Open (goto) page pointed to by link at point.
 `pmwiki-save'    - Save current buffer to the wiki engine.
 `pmwiki-save-as' - Save buffer to new page specified by group/name or URL.
 `pmwiki-reload'  - Reload the page.
 `pmwiki-browse'  - Show current buffer in browser.
 `pmwiki-search'  - Search the wiki site for a text.
 `pmwiki-map-site'  - Generate a map of the site (all groups and pages).
 `pmwiki-delete'  - Delete a page

 `pmichaud-open'  - Open page from the Pmichaud wiki.
 `lyx-open'       - Open a page from the LyX wiki.
 `lyx-save-as'    - Save current buffer to page at the LyX wiki.