Main

Others

txt2tags development reflexions

Projects to reuse for txt2tags

We can get inspiration / ideas from those projects. We can also implement txt2tags to them when it's possible.

http://code.google.com/p/ittyeditor/source/browse/ (convert html to markdown, and back, with js)
http://milianw.de/projects/markdownify/ (convert html to md)
http://codemirror.net/
http://jejacks0n.github.com/mercury/ (html/markdown editor)
http://www.raptor-editor.com (live editor)
https://www.mediawiki.org/wiki/WYSIWYG_editor
http://pelican.readthedocs.org/ (blogging system in python)
http://calepin.co/ (online system using dropbox and markdown)
http://getkirby.com/ (idem)
http://bbcomposer.elitwork.com/ (firefox extension for custom markup)

(from calepin) Because You’re Not Locked In

Find something that works better for you? No problem. Your .md files are small and portable, and aren’t locked away inside a proprietary format or hidden away inside an arcane XML file. They’re right there in a folder you own and control, ready to be used somewhere else if you need them.

http://wikirenderer.jelix.org/ (wiki engine)
http://qbnz.com/highlighter/ (syntax highlighter, we should try to add t2t to it)
https://github.com/adamzap/landslide/ (presentation)
http://nicedit.com/ : js wysiwym editor (like tinyMCE, FCKEditor)
http://files.wymeditor.org/ (wysiwym editor)
http://strapdownjs.com/ : markdown js processor
modx plugin http://modx.com/extras/package/phpmarkdownplugin
http://code.google.com/p/vimwiki/ (wiki using vim)

Tools / Software

What to use txt2tags for?

There are several tools in addition to txt2tags. On this page we list the tools according to their usage.

General tools

http://www.txt2tags.org/tools.html
Markitup syntax : http://etxt2tags.appspot.com/
Quicklook preview (mac os x) : http://www.mit.edu/~kimo/blog/quicklook.html

etherpad-lite

https://github.com/Pita/etherpad-lite/zipball/master

Etherpad-lite is almost txt2tags ready, there is a dokuwiki export which is close to txt2tags syntax. If you intend to export to txt2tags, just use those modifications on etherpad-lite/node_modules/ep_etherpad-lite/node/utils/ExportDokuWiki.js :

68c68
< var tags = ['======', '=====', '**', '//', '__', 'del>'];
---
> var tags = ['=', '==', '**', '//', '__', '--'];
255c255
< pieces.push(new Array(line.listLevel + 1).join(' ') + '* ');
---
> pieces.push(new Array(line.listLevel + 1).join(' ') + '- ');

You can also change etherpad-lite/node_modules/ep_etherpad-lite/templates/pad.html and call to <a id="exportdokuwikia" target="_blank" class="exportlink"><div class="exporttype" id="exportdokuwiki">Txt2tags text</div></a>

Geany

http://geany.org/
- On windows, in "tools", choose "edit configuration files" > "filetype_extensions.conf".
- On unix / linux edit /usr/share/geany/filetype_extensions.conf

Replace txt2tags=*.t2t; by Txt2tags=*.t2t;

Kate

Get this file, and rename it to txt2tags.xml
- On Windows, put it into C:\Program Files\KDE\share\apps\katepart\syntax
- On Linux and unix-like OS, put it into /usr/share/apps/katepart/syntax/

Scite

Get Scite from http://www.scintilla.org/SciTEDownload.html
To enable the txt2tags syntax hightlight (which is not enabled by default), open scrite as root, select "options" > open SciTEGlobal.properties ("open global options file"), then uncomment the lines starting with #&txt2tags|t2t||\ and the other one starting with #import txt2tags by removing the leading #. Txt2tags files will be recognised now.
- from scrite 3.2.0 "SciTEGlobal.properties" will be called ("open global options file") and the txt2tags import is prevented with the "imports.exclude" option. Remove txt2tags from it.
Sample SciTEUserProperties

Vim

Vim is already supporting txt2tags syntax.

In addition you can use VOoM which is a plugin for Vim that emulates a two-pane outliner:

The most recent version has support for txt2tags. Download Voom and save it within your ~/.vim folder. Then load it with

   :so ~/.vim/voom.vim

(for example). Then command

   :Voom txt2tags

creates outline from txt2tags section titles. Both numbered and non-numbered titles are recognized. Verbatim, Raw, and Tagged areas are ignored.

Screenshot (outline of the user guide)

Tip: to resize the voom panel to 30, type:

:vertical resize 30

Tip2: to load both the txt2tags plugin and the voom panel, add this to you ~/.vimrc:

au BufNewFile,BufRead *.t2t set syntax=txt2tags
au BufNewFile,BufRead *.t2t set nolist
au BufNewFile,BufRead *.t2t Voom txt2tags

(nolist is for preventing to cut words when using wrap)

Emacs

An emacs mode can be found in the "extra" tools folder of txt2tags. You can get it there as well.

Then save it for example to ~/.emacs.d/txt2tags/ and add to your ~/.emacs

;; txt2tags

 (add-to-list 'load-path "~/.emacs.d/txt2tags/")
 (setq auto-mode-alist (append (list
 	'("\\.t2t$" . t2t-mode)
 	)
 	(if (boundp 'auto-mode-alist) auto-mode-alist)
 ))
 (autoload  't2t-mode "txt2tags-mode" "Txt2tags Mode" t)

Direct export to PDF (without LaTeX)

wkhtmltopdf can convert html to pdf, with the use of webkit: https://code.google.com/p/wkhtmltopdf/

You can get your pdf this way:

txt2tags -t html file.t2t && wkhtmltopdf file.html file.pdf

Installing

See http://www.txt2tags.org/download.html
OpenSUSE: Application:Geo repository.
- Users simply have to add this URL to the package manager:

http://download.opensuse.org/repositories/Application:/Geo/<version>

txt2tags wiki

Others

txt2tags development reflexions

Projects to reuse for txt2tags

Tools / Software

What to use txt2tags for?

General tools

etherpad-lite

Geany

Kate

Scite

Vim

Emacs

Direct export to PDF (without LaTeX)

Installing

Links

Other tools

Social media

Twitter

Facebook

Other social media

Press and Articles about txt2tags

In English

In French

Tools similar to txt2tags (competitors)