philwilson.org :: jtextile

JTextile is in sourceforge

Phil Wilson — Wed, 23 May 2007 09:54:00 +0000

The source for JTextile is in SourceForge and I'll push a release with a .jar for download sometime soon. If you want to contribute, just leave a comment with your contact details and I'll add you as a committer.

The current source can be checked out by pointing your SVN client at https://jtextile.svn.sourceforge.net/svnroot/jtextile

Applications that use JTextile

Phil Wilson — Wed, 15 Mar 2006 10:52:00 +0000

In the last couple of weeks I've received word of three different applications which all use JTextile from their respective developers:

Jreepad is an excellent free "personal database" program - it's a great way to organise all your personal notes, thoughts, tasks, recipes, memories...

What's more, it's open-source and programmed in Java, so that all may benefit from it! Much used on Mac OSX, Linux, Unix, and even Windows!

Databinder is a programming toolkit for assembling database driven Web applications. It brings together Wicket and Hibernate, so you can start using the best programming technologies today, without fussing over their configuration.

TextileMe is simple gui swing based application to write textile files. This application implements all known textile processors written in java (Textile4J, JTextile).

Three very different uses of JTextile there, but all are really good - I'm very pleased that JTextile continues to be so useful!

JTextile 1.2

Phil Wilson — Thu, 02 Mar 2006 00:00:00 +0000

A small bugfix based on a report from Nathan Hamblen to allow blockquote without the cite attribute like this:

bq. my quoted text

Obviously I broke this behaviour in a patch in 2003 and no-one noticed.

Download JTextile 1.2

JTextile demo now on http://philwilson.org/jtextile

Phil Wilson — Mon, 14 Mar 2005 11:57:00 +0000

The JTextile demo can now be seen on http://philwilson.org/jtextile so that people don't need to open ports on their firewall as well as still being on the original http://philwilson.org:8180/jtextile. It's also a much cleaner URL.

JTextile 1.1

Phil Wilson — Sat, 05 Mar 2005 22:42:00 +0000

JTextile 1.1 was release in mid-2004 (I think). This is just a catch-up post :)

Download JTextile 1.1.

See the source

About JTextile

Phil Wilson — Sat, 05 Mar 2005 22:30:00 +0000

JTextile is a Java implementation of Dean Allen's Textile, a “humane web text generator”. It uses the GNU regular expression library.

JTextile was written by Gareth Simpson after prompting by me. We both patch it when necessary.

It is released under the same liberal open source license as the original Textile.

Currently JTextile does not support all of the original Textile syntax. The most obvious omission is support for tables:

USING TEXTILE

Block modifier syntax:

Header: hn. 
Paragraphs beginning with 'hn. ' (where n is 1-6) are wrapped in header tags.
Example: <h1>Text</h1>

Header with CSS class: hn(class).
Paragraphs beginning with 'hn(class). ' receive a CSS class attribute. 
Example: <h1 class="class">Text</h1>

Paragraph: p. (applied by default)
Paragraphs beginning with 'p. ' are wrapped in paragraph tags.
Example: <p>Text</p>

Paragraph with CSS class: p(class).
Paragraphs beginning with 'p(class). ' receive a CSS class attribute. 
Example: <p class="class">Text</p>

Blockquote: bq.
Paragraphs beginning with 'bq. ' are wrapped in block quote tags.
Example: <blockquote>Text</blockquote>

Blockquote with citation: bq(citeurl).
Paragraphs beginning with 'bq(citeurl). ' recieve a citation attribute. 
Example: <blockquote cite="citeurl">Text</blockquote>

Numeric list: #
Consecutive paragraphs beginning with # are wrapped in ordered list tags.
Example: <ol><li>ordered list</li></ol>

Bulleted list: *
Consecutive paragraphs beginning with * are wrapped in unordered list tags.
Example: <ul><li>unordered list</li></ul>


Phrase modifier syntax:

_emphasis_             <em>emphasis</em>
__italic__             <i>italic</i>

*strong*               <strong>strong</strong>
**bold**               <b>bold</b>
??citation??           <cite>citation</cite>
-deleted text-         <del>deleted</del>

+inserted text+        <ins>inserted</ins>
^superscript^          <sup>superscript</sup>
~subscript~            <sub>subscript</sub>
@code@                 <code>computer code</code>

==notextile==          leave text alone (do not format)

"linktext":url         <a href="url">linktext</a>
"linktext(title)":url  <a href="url" title="title">linktext</a>

!imageurl!             <img src="imageurl">
!imageurl(alt text)!   <img src="imageurl" alt="alt text" />

!imageurl!:linkurl     <a href="linkurl"><img src="imageurl" /></a>

ABC(Always Be Closing) <acronym title="Always Be Closing">ABC</acronym>

In addition it:

Replace single and double primes (' and ") used as quotation marks with HTML entities for opening and closing quotation marks (‘’ and “”) in readable text, while leaving untouched the primes required within HTML tags.

Replaced double hyphens (--) with an em-dash (—) entity.

Replace single hyphens surrounded by spaces with an en-dash (–) entity.

Replace triplets of periods (...) with an ellipsis (…) entity.

Convert many nonstandard characters (ŸúßŠ?Œ) to browser-safe entities corresponding to keyboard input.

Apply block- and phrase-level structural tags automatically and at the discretion of the writer via quick tags.

Create hyperpnks and insert images via quick tags.

Define acronyms via quick tags
Wrap an <acronym> tag around runs of three or more capital letters automatically.

Convert (TM), (R), and (C) to ™, ®, and ©

Convert the letter x to a dimension sign: 2x4 to 2×4 and 8 x 10 to 8×10

_{- from "what does it do?" on the Textile homepage}

known bugs

none

fixes and changes to date:

Large reworking of code, including making sure we don't suffer the same bugs as textile4j (gareth 24/05/2004)
open and close single quotes now work correctly (phil 24/04/2003)
number-hyphen-number is changed to number-en-dash-number a la 12-13 -> 12–13 (phil 24/04/2003)
small spacing error with double quotes (phil 05/06/2003)
small fix plus ability to add blockquote cite attribute: bq(URL). text (phil 09/07/2003)