2lazy2rest

A simple way to produce short-to-medium document using reStructuredText

Multi-format themes

Render the same document in HTML, ODT, PDF keeping the main visual identity

Unified interface

Tired of switching between rst2* tools having different arguments or behavior ?
Would like to not lose code-blocks or some rendering options switching the output format ?

This tool try to address this

Make your own theme

TODO: templates will be customizable easily (say, probably colors only)

How to use it

Dependencies

You’ll need rst2pdf to use all the features, other rst2* tools are coming from docutils.

Using

mkrst [-h] [--html] [--pdf] [--odt] [--theme THEME]
             [--themes-dir THEMES_DIR]
             FILE

optional arguments:

-h, --help: show this help message and exit
--html: Generate HTML output
--pdf: Generate PDF output
--odt: Generate ODT output
--theme THEME: Use a different theme
--themes-dir THEMES_DIR: Change the folder searched for theme

popo:~/2lazy2rest% ./mkrst test_page.rst --html --pdf
Using ./themes/default
  html:  test_page.html
   pdf:  test_page.pdf

Customizing

Make a copy of themes/default, edit to your needs the copy and use the –theme option with the name of your copy, that’s All !

Example

popo:~/2lazy2rest% cp -r themes/default themes/red
popo:~/2lazy2rest% sed -si 's/#FEFEFE/red/g' themes/red/html/stylesheet.css
popo:~/2lazy2rest% ./mkrst test_page.rst --html --theme red

Issues

ODT style is unfinished
PDF & HTML still needs more ReST coverage
No skin generation from template yet

Metadata

Release files for 2lazy2rest 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for 2lazy2rest 0.2.2
File	Size	Uploaded
2lazy2rest-0.2.2.tar.gz	4.9 MB	Aug 15, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for 2lazy2rest 0.2.2
File	Interpreter	ABI	Platform	Reset
2lazy2rest-0.2.2-py3-none-any.whl 4.9 MB Aug 15, 2023	Python 3	none	any	Details

Total release size: 9.7 MB

Release files / 2lazy2rest-0.2.2.tar.gz

Download URL	2lazy2rest-0.2.2.tar.gz
Size	4.9 MB
Tags	Source
SHA-256 checksum How to use checksums	`b30dec3755f12ae88c6150bfd6a9cc8a8d34f72561cff807a3b89c42a133291e`
BLAKE2b-256 checksum How to use checksums	`a45ad5cc6a44ad07b238717494b1c5b6d6cb20637abfc919754375ee572d9594`
Upload date	Aug 15, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.5.1 CPython/3.11.3 Linux/6.4.10-zen2-1-zen`

Release files / 2lazy2rest-0.2.2-py3-none-any.whl

Download URL	2lazy2rest-0.2.2-py3-none-any.whl
Size	4.9 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`a145ee8745a26d0ab2926a5ea8c6334914acc2031be807a5236479f3deaa5e60`
BLAKE2b-256 checksum How to use checksums	`0c8dd4bd10005425a6213fabe556a6d0b098c3fa85d046420b398eff04632b9b`
Upload date	Aug 15, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.5.1 CPython/3.11.3 Linux/6.4.10-zen2-1-zen`