ReText is a Linux ready, simple (yet powerful) text editor for Markdown and reStructured text. ReText includes a built in "Live preview" function so that writers can see their changes in real-time.
Emerge ReText just like any standard program:
emerge --ask app-editors/retext
If you start ReText and upon startup get messages such as these:
Traceback (most recent call last): File "/usr/bin/retext", line 1530, in <module> main(sys.argv[1:]) File "/usr/bin/retext", line 1517, in main window = ReTextWindow() File "/usr/bin/retext", line 547, in __init__ self.tabWidget.addTab(self.createTab(""), self.tr('New document')) File "/usr/bin/retext", line 605, in createTab if self.useWebKit: AttributeError: 'ReTextWindow' object has no attribute 'useWebKit'
then you will need to build dev-python/PyQt4 with the
webkit USE flag enabled. The way of resolving this issue is to modify the /etc/portage/package.use file by adding
echo "dev-python/PyQt4 webkit" >> /etc/portage/package.use
For more information on USE flags see the Handbook's USE flag documentation.
If you switch on
webkitUSE flag for dev-python/PyQt4, it requires the package libxml2 with the
icuUSE flag enabled. This will most likely lead to unsolvable Portage conflicts. If you find yourself in this situation try adding
icuas a global USE flag in the /etc/portage/make.conf and re-emerging world. This is a pain but it will fix the problem.
USE="... icu ..."
Finally rebuild the system's world packages. This should satisfy all related issues:
emerge -uN @world
If done correctly any packages that support
icu will be rebuilt, including webkit. The above command will probably take quite a while, but having a Markdown editor is worth it, right?!
No icons in toolbar
If the icons are missing the icon theme needs to be specified in gconf or in the ReText configuration file.
Available icon themes are located in /usr/share/icons/ (hicolor will not work).
- Jekyll - Markdown-powered website software.