NAME

       editmoin - Edit MoinMoin wiki pages in your favourite editor

SYNOPSIS

       editmoin http://moinmo.in/WikiSandBox

       editmoin -t SomeTemplate http://moinmo.in/WikiSandBox

DESCRIPTION

       editmoin allows you to edit Moin wiki pages with your preferred editor. It means you can easily edit your
       pages, without the usual limitations of most web browsers' text areas.

       Its usage is simple and straightforward. Just provide moin's web page url as  the  first  parameter.  For
       example:

              editmoin http://moinmo.in/WikiSandBox

       You can also use the -t parameter, to inform a template to base this page on. For example:

              editmoin -t SomeTemplate http://moinmo.in/WikiSandBox

CHANGE SETTINGS

       While you're editing a page you'll notice that a few settings are available at the top of the page. These
       settings are preceded by a @ symbol, and are immediately followed by the page body. These settings  allow
       you  to  inform,  for example, if you want subscribing users to be notified of your changes, or provide a
       comment for your change. Their functionality is simple, and their meaning, format, and  usage  should  be
       obvious to you.

SELECTING YOUR EDITOR

       The  default  editor  is  vi.  If  you  want  to  use any other, just set the EDITOR environment variable
       accordingly.

SETTING YOUR USERNAME

       For editmoin to be able to authenticate you against the moin site you're accessing,  it  must  know  your
       username.  For that, you must edit the file ~/.moin_users and insert URL ID pairs in it. For example:

              http://moinmo.in YourUserName

              http://wiki.ubuntu.com

              http://example.com/moin/moin.cgi AnotherUserName

       If the server needs Basic HTTP Authentication you can use something like:

              https://user:password@example.com/moin/moin.cgi YourUserName

       For  using  shortcuts  (see  below), and also for better control, defining URLs without usernames in that
       file is valid.

SETTING YOUR MOIN ID EXPLICITLY

       In remote times, authentication was done in moin using an ID, consisting  mostly  of  numbers.   Nowadays
       moin  was  improved  to  work  with  a  more  traditional  username/password  scheme.   Even then, if the
       traditional username scheme mentioned above doesn't work  for  you,  IDs  may  still  be  obtained  after
       authentication, when the moin site sends your browser a MOIN_ID or MOIN_SESSION cookie.

       Setting  moin  IDs  consists  of  changing a file named ~/.moin_ids and inserting URL ID pairs in it. For
       example:

              http://moinmo.in 987654321.321.54321

              http://wiki.canonical.com

              http://example.com/moin/moin.cgi 123456789.123.12345

       If the server needs Basic HTTP Authentication you can use something like:

              https://user:password@example.com/moin/moin.cgi 123456789.123.12345

       You can use a command like this to create a ~/.moin_ids file from your current Firefox profile:

       sqlite3 -separator ' ' .mozilla/*/*.default/cookies.sqlite \
         "SELECT host,value FROM moz_cookies WHERE name LIKE 'MOIN_SESSION'" \
         | sed 's_^_https://_' > ~/.moin_ids

       For using shortcuts (see below), and also for better control, defining URLs without IDs in that  file  is
       valid.

ALIASES

       Besides  using shortcuts, it's also possible to define URL aliases in a file named ~/.moin_aliases.  This
       file should contain lines with pairs of "alias translation". For instance:

              script http://moinmo.in/ScriptMarket

       With this line present, one may execute a command like follows:

              editmoin script/EditMoin

       and get the expected result.

       Notice that unlike shortcuts,  aliases  must  match  exactly  to  be  considered.   After  the  alias  is
       translated, the resulting URL is also processed for matching shortcuts as specified below.

SHORTCUTS

       Instead  of  using  the  whole  URL,  you  may  use a shortcut, which consists of any substring of an URL
       contained in ~/.moin_users and/or ~/.moin_ids, followed by a slash and an optional subpath. For instance:

              editmoin canonical/FrontPage

PROXIES

       If you're behind a proxy, set the http_proxy environment variable, as usual.

BACKUPS

       Editing a moin page may take several minutes, or even hours sometimes.  With  this  in  mind,  after  you
       change some page it is saved in a file named ~/.moin_lastedit even before trying to commit it. This gives
       an extra protection against casual problems. Note that this file is overwritten  every  time  a  page  is
       successfuly changed, so save it somewhere if you want to keep it.

AUTHOR

       editmoin  was written by Gustavo Niemeyer <gustavo@niemeyer.net>. This manpage was written by Martin Pitt
       <mpitt@debian.org> for the Debian GNU/Linux System (but may be used by others), based on editmoin's  home
       page.