ReText Webpages Generator (WpGen) is an useful tool for generating html pages to use on your web site. It's possible to use WpGen directly from ReText 0.7+. Also, a command-line interface is available. Using via the GUI Save some documents in one directory and open one of them in ReText Select "File → Directory → Generate webpages" in the menu Using via the command-line tool Create an empty directory. Open a terminal at that directory and enter wpgen init to create neccesary files. Create the pages in that directory. Both Markdown and ReST pages are supported. index.mkd page is used as the home page. Run wpgen updateall to create ready-to-use HTMLs. You can also use wpgen update PAGENAME to process only one page. You can specify some Markdown extensions that your website needs in markdown-extensions.txt file of WpGen's working directory; separate them using a line break. Customizing the look To customize the look, edit the html/style.css file. You can also use some built-in CSS styles by entering wpgen usestyle %Style%. By default, WpGen comes with three themes: "Simple", "Default" (grey-colored) and "Blue". To customize page layout, edit the template.html file. Note: if command wpgen does not work (for example, if you have downloaded retext from here), replace it with the full path to wpgen.py file. Also, if wpgen init doesn't work, run it from the wpgen/ directory first, and the copy pages/, html/ directories and template.html file to another directory.
Last updated: 2014-08-28
Quick Start Guide
This is a quick guide for starting to work with ReText. System Requirements Any modern operating system Python 3.x Qt 5 libraries PyQt bindings PyMarkups Python-Markdown and/or Docutils This component is needed if you want to use some extra features: PyEnchant - for spell checking support Debian users can find ReText in their testing repository, and Ubuntu users can install it from ppa:mitya57. Users of other systems can download ReText from the Downloads page. Users of non-X11 systems should also download the icons pack and extract it into icons sub-directory of ReText installation directory. Starting up After you open ReText, the main editing area will be shown. You can now type the text in your favourite markup language. You can switch between Markdown and ReStructuredText using "Edit → Default editing mode" menu (if both modules are installed). For preview, click "Preview" button or press Ctrl+E. To enable two-panel mode, activate "Live Preview" from "Edit" menu or press Ctrl+L. To insert a page break, look at this page. To see pages layout, use "File → Print Preview" menu option. To set a font, use "Edit → Change default font" option. Files are opened and saved just like in all other text editors. To export a file to a different format, use "File → Export" menu. Next steps Look at our Webpages Generator guide or learn how to tune ReText using the configuration file.
Last updated: 2014-12-17
Here some basic testing procedures are listed. Current version is for ReText 3.0. If you find an issue/bug, please report it! Python 3 support Just run ReText with Python 3 (python3 /usr/bin/retext, or python3 /path/to/retext.py) Google Docs support Just export your document to Google Docs and check if it's exported with correct formatting, etc Update your document and export it again, ensure that the document on the server is replaced ut available under the same URL WebKit support Ensure that the parsing engine is correctly switched via the menu ("Edit → Enable WebKit engine"), and the current layout (editing/preview/live-preview) is preserved Ensure that printing works Ensure that PDF/ODT/GoogleDocs export works correctly Plain Text support Use Plain text (in menu, check "Edit → Plain text") Check if PDF/ODT/GoogleDocs export works correctly Check if HTML files are saved with .html extension and Plain text — with .txt and then opened with correct editing mode Export Extensions support [Export Extensions] were introduced in ReText 3.0 and allow you to add your own export functions to ReText. See the documentation linked for details, write your own extensions and report any issues you find. Other issues ReText can display some warnings in its Terminal output. Please report all these things.
Last updated: 2014-03-04