Users with many Textile files in their Jekyll Pages site can leverage [pandoc](http://pandoc.org), a utility for converting between different markup formats.
-This [`tomd`](https://github.com/jldec/tomd) shell script uses [awk](http://www.grymoire.com/Unix/Awk.html) and [sed](http://www.grymoire.com/Unix/Sed.html) to overcome the biggest limitations of pandoc, filtering out the sections listed below, which pandoc doesn't recognize, and re-inserting them into the converted Markdown.
+The [`tomd`](https://github.com/jldec/tomd) shell script uses [awk](http://www.grymoire.com/Unix/Awk.html) and [sed](http://www.grymoire.com/Unix/Sed.html) to overcome the biggest limitations of pandoc, filtering out the sections listed below, which pandoc doesn't recognize, and re-inserting them into the converted Markdown.
- YAML frontmatter at the top of .textile files
-`{% highlight %}` blocks
-`<notextile>` blocks
-NOTE: This process may still produce some incorrect output. Known issues include:
-
-- Lost CSS references e.g. from Textile `.p(classname)`
-- Literal HTML mixed with unconverted Textile formatting
-
###To run `tomd`
1. Install pandoc from https://github.com/jgm/pandoc/releases or [here](http://pandoc.org/installing.html).
2. [Download](https://github.com/jldec/tomd/archive/v1.0.zip) or clone this repo.
-3. Copy the `tomd` script and the 2 awk files into your Jekyll project.
-4.Run the script from inside your Jekyll project folder.
+3. Copy the `tomd` script and the two `.awk` files into your Jekyll project.
+4.Invoke the script with `./tomd` from inside your Jekyll project folder.
5. Validate the results.
The script will look for any `.textile` files in the `_posts` directory, convert them to `.md`, and leave backups of the original `.textile` files in a new directory called `_old_posts`. You can override the names of the directories with arguments to the script.
0 comments on commit
e61b559