rst2textile is docutils textile writer convert reStructuredText(rst) to Textile format.
Features
Docutils writer for textile.
supported syntaxes are:
headings: h1/h2..
docinfo: field-list (like :Date: today) at top of rst file.
paragraph
emphasis: *em*
strong: **strong**
list-item: * egg
enum-item: #. ham
blockquote
link: `foo <http://example.com/>`_
image: .. image:: http://example.com/image.png
literal: ``some code`` and ::
Sphinx textile builder (experimental).
write conf.py extensions = [‘docutils_textile’]
build by sphinx-build -b textile source _build/textile
Install
$ pip install rst2textile
If you wanto to use unrelease version, you can install from repository:
$ pip install -e hg+https://bitbucket.org/shimizukawa/rst2textile#egg=rst2textile
Run
$ rst2textile.py input.rst output.txt
or:
$ python -m rst2textile input.rst output.txt
Test
$ python setup.py test
or:
$ python test.py
Depends
Python 2.6, 2.7, 3.3, 3.4
Docutils 0.12, 0.11, 0.10
Limitation
Not supported: some textile syntax at http://redcloth.org/textile
ToDo
Documentation
Implement some textile format.
CHANGES
0.2.1 (2014/10/04)
Fix: number of table columns reduced to shorter row.
0.2.0 (2014/10/04)
add support textile table output. Thanks to tell-k.
remove pysetup related lines.
change supported python versions: 2.6, 2.7, 3.3, 3.4
change supported docutils versions: 0.12, 0.11, 0.10
0.1.1 (2012/4/29)
add supported python versions: 2.4, 2.5, 2.6, 3.1, 3.2, 3.3
0.1.0 (2012/4/22)
first release
supported syntax: h1/h2.., docinfo, paragraph, em, strong, list-item, enum-item, blockquote, link, image, literal
Convert Samples
Heading1
rst:
========== Heading1 ==========
textile:
h1. Heading1
Headings
rst:
========== Heading1 ========== Heading2 ========== Heading3 ---------- Heading4 ^^^^^^^^^^
textile:
h1. Heading1 h2. Heading2 h3. Heading3 h4. Heading4
Document Information
rst:
HelloWorld =========== :Date: Today :Author: SpamEgg :Location: Here
textile:
h1. HelloWorld Date: Today Author: SpamEgg Location: Here
Paragraph
rst:
Normal Text
textile:
Normal Text
Emphasized
rst:
*emphasized* (e.g., italics)
textile:
_emphasized_ (e.g., italics)
Strongly emphasized
rst:
**strongly emphasized** (e.g., boldface)
textile:
*strongly emphasized* (e.g., boldface)
List items
rst:
- An item in a bulleted (unordered) list
- Another item in a bulleted list
- Second Level
* Second Level Items
* Third level
textile:
* An item in a bulleted (unordered) list * Another item in a bulleted list ** Second Level ** Second Level Items *** Third level
Enumerated list items
rst:
#. An item in an enumerated (ordered) list xxxxxxx #. Another item in an enumerated list yyyyyy #. Another level in an enumerated list vvvvvvvv #. Another level in an enumerated list vvvvvvvv #. 3rd element at indent level1
textile:
# An item in an enumerated (ordered) list xxxxxxx # Another item in an enumerated list yyyyyy ## Another level in an enumerated list vvvvvvvv ## Another level in an enumerated list vvvvvvvv # 3rd element at indent level1
Blockquotes
rst:
Blockquotes This text will be enclosed in an HTML blockquote element. Second Paragraph.
textile:
Blockquotes bq. This text will be enclosed in an HTML blockquote element. bq. Second Paragraph.
Links
rst:
`link text and link target url <http://www.example.com/link/target/address>`_
textile:
"link text and link target url":http://www.example.com/link/target/address
Images
rst:
.. image:: http://example.com/image.jpg .. figure:: local/image/path.png
textile:
!http://example.com/image.jpg! !local/image/path.png!
Inner Reference
rst:
HelloWorld =========== reference to HelloWorld_ !
textile:
h1. HelloWorld reference to "HelloWorld" !
Literal (code)
rst:
::
class Foo(object):
def __init__(self, value):
print "value = %d" % value
raise NotImplementedError(u'EmptyClass')
textile:
<pre>
class Foo(object):
def __init__(self, value):
print "value = %d" % value
raise NotImplementedError(u'EmptyClass')
</pre>
Tables
rst:
+------------------------+------------+----------+----------+ | Header row, column 1 | Header 2 | Header 3 | Header 4 | | (header rows optional) | | | | +========================+============+==========+==========+ | body row 1, column 1 | column 2 | column 3 | column 4 | +------------------------+------------+----------+----------+ | body row 2 | ... | ... | | +------------------------+------------+----------+----------+
textile:
|_. Header row, column 1 (header rows optional)|_. Header 2 |_. Header 3 |_. Header 4 | | body row 1, column 1 | column 2 | column 3 | column 4 | | body row 2 | ... | ... | |
rst:
===== ===== ======= A B A and B ===== ===== ======= False False False True False False False True False True True True ===== ===== =======
textile:
|_. A |_. B |_. A and B | | False | False | False | | True | False | False | | False | True | False | | True | True | True |
CSV Table
rst:
.. csv-table:: :header: "Treat", "Quantity", "Description" :widths: 15, 10, 30 "Albatross", 2.99, "On a stick!" "Crunchy Frog", 1.49, "If we took the bones out, it wouldn't be crunchy, now would it?" "Gannet Ripple", 1.99, "On a stick!"
textile:
|_. Treat |_. Quantity |_. Description | | Albatross | 2.99 | On a stick! | | Crunchy Frog | 1.49 | If we took the bones out, it wouldn't be crunchy, now would it?| | Gannet Ripple | 1.99 | On a stick! |
List Table
rst:
.. list-table::
:widths: 15 10 30
:header-rows: 1
* - Treat
- Quantity
- Description
* - Albatross
- 2.99
- On a stick!
* - Crunchy Frog
- 1.49
- If we took the bones out, it wouldn't be
crunchy, now would it?
* - Gannet Ripple
- 1.99
- On a stick!
textile:
|_. Treat |_. Quantity |_. Description | | Albatross | 2.99 | On a stick! | | Crunchy Frog | 1.49 | If we took the bones out, it wouldn't be crunchy, now would it?| | Gannet Ripple | 1.99 | On a stick! |
1 maintainer
Metadata
1 maintainer
Release files for rst2textile 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| rst2textile-0.2.1.tar.gz | 11.7 kB | Without provenance | Details for rst2textile-0.2.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| rst2textile-0.2.1-py2.py3-none-any.whl | Python 2, Python 3 | none | any | Details for rst2textile-0.2.1-py2.py3-none-any.whl |
Total release size: 25.7 kB
Release files / rst2textile-0.2.1.tar.gz
| Download URL | rst2textile-0.2.1.tar.gz |
|---|---|
| Size | 11.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
17f8005408f2928ac2c394d12c895aca9e331e08a5adcac7d19a773fb8b60a3b
|
|
BLAKE2b-256 checksum How to use checksums |
242aef3c5165dc8f1b416b963970a6fef297ac318b4d2ad8bffac5ebb6796cc4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / rst2textile-0.2.1-py2.py3-none-any.whl
| Download URL | rst2textile-0.2.1-py2.py3-none-any.whl |
|---|---|
| Size | 14.0 kB |
| Tags | Python 2 Python 3 |
|
SHA-256 checksum How to use checksums |
3108844f02cf8da8c0483126ac952efec19a8cec98ca818488c57e51ee653916
|
|
BLAKE2b-256 checksum How to use checksums |
0767761fa22dbc667f621f79e3747d01ef93a8443d6d049d5ee13f3d279ed7e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for rst2textile 0.2.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
