Standalone reStructuredText editor with live preview (native app)
RSTPad
reStructuredText editor with live preview.
.. image:: screenshot.png
.. contents::
Features
live preview with autoscroll
configurable orientation (horizontal / vertical)
search & replace
toolbar with common elements:
inserting highlighted code blocks (Pygments)
built-in help pages
export to PDF
Known limitations
Implementation details
the application contains an embedded Python interpreter
the Docutils library is used to convert RST to HTML on the fly
HTML output is displayed using Qt WebEngine
Compilation
Pygments <https://pypi.python.org/pypi/Pygments>
_ (tested with 2.1.3)Docutils <https://sourceforge.net/p/docutils/code/HEAD/tree/trunk/docutils/>
_ (tested with 0.13, revision 7975).. NOTE::
Copy rstpad.local.pro.dist, name it rstpad.local.pro and set the following variables:
PYTHON_LINK
Python linker flags
Windows: -LC:/python/libs -lpython27
OS X: use the python-config <http://manpages.ubuntu.com/manpages/precise/man1/python-config.1.html>
_ utility to determine linker flags:
python2.7-config --ldflags
PYTHON_INCLUDE_PATH
path to a directory containing Python's header files
C:/python/include
/usr/include/python2.7
PYTHON_SYS_PATH
path to a directory containing:
libs.zip
- the Python standard library as a ZIP archivepygments
, docutils
- library directories (these cannot be inside libs.zip).pyc files should be excluded
#. Use the Windows Deployment Tool <http://doc.qt.io/qt-5/windows-deployment.html#the-windows-deployment-tool>
_ with the release binary to fetch required DLLs.
Example: windeployqt.exe --release --no-translations rstpad.exe
#. Locate and copy the correct python27.dll
file or the application won't work on machines without Python 2.7 installed.
possible locations depend on how you've installed Python and on its version:
make sure you're ussing the correct version (32 vs 64bit)
Use the Mac Deployment Tool <http://doc.qt.io/qt-5/osx-deployment.html#the-mac-deployment-tool>
_ to convert the resulting application into a .dmg file:
::
macdeployqt RSTPad.app -dmg
Not tested yet. You're on your own :)