Trac Wiki View
The Trac Wiki view is for browsing an editing a trac websites wiki pages.
Opening View
To open the wiki view use the command
:TWOpen <OptionalWikiPage>
If no page argument is given the plugin will open the main page WikiStart by default
Browsing/Editing
The WIKITOC_WINDOW will show a list of pages. Scrolling up and down and Pressing <return> on a page will open the selected page in the WIKI_WINDOW
(added in 0.2.4) Pressing <space> over the page in the WIKITOC_WINDOW will display the page in a browser
Trac sites usually have a bunch of in built pages Trac* or Wiki* you can hide these from view by setting the global variable in your vimrc.
let g:tracHideTracWiki = 'yes'
At the moment this is done with a simple regexp so if you name your own pages Trac... or Wiki... they will not appear on the Table of Contents.
You can also load a page by pressing the usual tag jump <c-]> to open the page under the cursor. At the moment theres no page name validation so it will throw an error if you try an open a nonexistant page.
Adding/ Retrieving an Attachment
(Added 0.2.3)
:TWAddAttachment <file_path>
adds an attachment to the current active wiki page
:TWGetAttachment <file>
gets an attachment from the active Wiki Page and save it to the current working directory. (As of 0.2.3 will overwrite any current files of the same name)
If a Wiki page opened contains attachments The Wiki Attachment window will appear. Attachments can be downloaded by hovering over the desired attachment and pressing <enter>
HTML Preview
:TPreview
displays the current wiki in html preview (only tested on lynx set g:tracBrowser)
You can also use the shortcut <leader>tp
Committing pages to the Trac Site
To save a page you can type in the command view
:TWSave <optional wiki update comment>
Alternatively you can quickly save a page with your regular :wq<cr> or :w<cr> which I've mapped to perform the TracSaveWiki? command.
Exiting Trac Wiki View
Exiting is done by either the command :TClose, :wq<cr> or :q<cr> in either of the wiki windows
Outstanding Bugs
Planned Enhancements
- #31
- Open multiple wiki's at once
