AsciiDoc Package for Sublime Text2
- Total 7K
- Win 3K
- OS X 3K
- Linux 2K
|Aug 20||Aug 19||Aug 18||Aug 17||Aug 16||Aug 15||Aug 14||Aug 13||Aug 12||Aug 11||Aug 10||Aug 9||Aug 8||Aug 7||Aug 6||Aug 5||Aug 4||Aug 3||Aug 2||Aug 1||Jul 31||Jul 30||Jul 29||Jul 28||Jul 27||Jul 26||Jul 25||Jul 24||Jul 23||Jul 22||Jul 21||Jul 20||Jul 19||Jul 18||Jul 17||Jul 16||Jul 15||Jul 14||Jul 13||Jul 12||Jul 11||Jul 10||Jul 9||Jul 8||Jul 7||Jul 6|
AsciiDoc Package for Sublime Text
Currently looking for a maintainer!
Sublime Text is compatible with the Textmate editor for OS X snippets, preferences and languages file. However, even though Sublime can recognize the Textmate snippets, some features such as tab completion and shortcut commands do not work out of the box. This package overcomes these limitations.
All the files provided here should work in Windows 7 and OS X Lion.
Installation (Package Control)
Find the package on Package Control under the name
To install the package manually, follow these steps:
- Download the zip containing src files.
- Extract the files to AsciiDoc folder (create this folder if not present already) under:
%APPDATA%\Sublime Text 3\Packages\
- OS X:
~/Library/Application Support/Sublime Text 3/Packages
- Portable Installation:
Sublime Text 2/Data
- Close all instances of Sublime Text and relaunch the editor.
If successful, you should see AsciiDoc entry under
View > Syntax and under
Tools > Snippets.
Note: Snippets may take few seconds to load under Windows.
Configure Variables: TM_FULLNAME, TM_EMAIL, etc.
The Article snippet refers to certain variables that are styled after the TextMate standard for environment variables (as do other features of Sublime). These variables are configured via the Default.tmPreferences file.
- Edit Default.tmPreferences
- Replace “My Full Name”, “My Email”, and “My Company” with your actual name, email address, and company name.
- Update the defintion of TM_YEAR (currently 2013) if necessary.
- Test the Article snippet (create a new AsciiDoc file, type “ar” and hit Tab).
Configure the AsciiDoc Build System
Sublime has a build system for compiling source code, in this case, AsciiDoc source. A file called asciidoc.sublime-build is provided here to allow you to take advantage of the build system, but it needs to be told where you have installed Python and AsciiDoc:
- Edit asciidoc.sublime-build
- Change the working_dir from “/path/to/asciidoc-8.6.8” to the actual location where you have AsciiDoc installed (e.g. “C:\prgs\asciidoc-8.6.8”)
- Change the first parameter of cmd from “/path/to/python” to actual name and location of your Python engine (e.g. “C:\Python27\python.exe”)
- Note: See below about ctrl+b no longer being the shortcut key for the buld system.
- Create a new file, save it as
- Start typing AsciiDoc!
Snippets can be inserted anywhere by using the menu command
Tools > Snippets > AsciiDoc or by typing two initial characters and hitting tab to complete.
A few tab completion examples are:
- Start a new article (type
- Comments (type
- Headings (type
h4 TABfor one-liner versions)
- Table generation (type
- Tab expansion for blocks (type
- Sidebar block (type
- Add a definition to a glossary (type
- Refer to a glossary definition elsewhere (type
Article:: When you first invoke the Article snippet, “Title” will be highlighted. Type over it with the actual title you want. (Notice that the new title will be automatically underlined to length.) Hit tab to move off the title, and the backend choices will be highlighted. These are only the 3 most popular backends. Either delete 2 of them, or type over the whole thing with a 4th choice (e.g. manpage). Hit tab to move to the end.
Definition and Definition Link:: Use these to create glossary definitions with anchors and corresponding references to them. Note how the anchor tags will be automatically composed as you type the name of the term being defined, and also how any non-alphanumeric characters are automatically left out of the tag.
Basic support for some handy shortcuts are now available:
- Bold selection: Select some text and then press
- _Italic_ize selection: Select some text and then press
- Mark selection as Code literal: Select some text and then press
- Mark selection as filename: Select some text and then press
ctrl+b overrides the standard key binding of
Tools > Build System. If this bothers you, you can edit the
.sublime-keymap files (based on your OS) under
Time permitting, I'll add more shortcuts but meanwhile if you come upon something useful, feel free to submit a patch!
Following are planned enhancements for the package:
- Add keyboard shortcuts for various commands such bold text, italics, blocks etc.
- Adding Build system to preview as HTML or PDF.
Your suggestions are welcome.
Author & Credits
Created by Hrusikesh Panda. Copy left or right, as you wish.
Credit goes to Christian Zuckschwerdt for his original work on AsciiDoc TextMate bundle.
The Article, Definition, and Definition Link snippets were written by Craig Jones.