/usr/share/doc/pyrite-publisher/README.GUI is in pyrite-publisher 2.1.1-10.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 | The Pyrite Publisher graphical interface uses wxPython; to use it you
will need wxWidgets and wxPython installed. (Pyrite Publisher will
work just fine without wxPython, but you'll have to use the command
line, which may not even be possible under Windows.) You can get
wxWidgets at http://www.wxwidgets.org/ if you don't have it already.
If you are on Windows and you aren't familiar with using and
developing in Python, it is probably best to wait until a turnkey
installation package is ready.
If you run pyrpub without any arguments, it will try to start the GUI.
You'll need to make sure you have wxPython installed for this to work
- on Debian, install package python-wxgtk3.0.
The main window should be pretty straightforward: put the filename of
the file you want to convert in the topmost text box (or use the
"Choose" button next to it to browse) and click on "Convert". If you
leave the "output file" box empty the converted file will be placed in
the current directory; otherwise, you can enter a filename here.
The "advanced options" are intended to be a substitute for the most
commonly used command-line options:
The "queue for installation" checkbox is the equivalent of the -i
option on the command line; it tries to install the converted data
using the most appropriate method it knows about, (usually) instead of
making a converted file. (On Windows this doesn't work at all yet.)
The "Copy Docs directly" checkbox is used for converting between
document formats; it enables the "CopyDoc" plugin so that if you give
a .pdb file as input it will be processed in raw form. This is only
useful if you select zTXT output and convert a Doc, or vice versa.
The "Doc Output" picker forces the use of a particular doc-output
plugin. It will list all plugins which handle e-text output; choose
<Automatic> to let Pyrite Publisher choose.
Likewise, the "Doc Format" picker forces the use of a particular
doc-assembler plugin. It will list all plugins which process markup
for e-texts.
Similarly, the "Text Parser" picker forces the use of a particular
parser for plain text files. It will list all plugins that handle the
text/plain MIME type.
Choosing any option that forces the use of a plugin is exactly like
using the "-P" option on the command line, which means that if you
have selected options that don't make sense for the file you are
trying to convert, an error will occur.
Also of note: the File menu has a "Plugins" option which shows a
somewhat ugly information panel about each installed plugin. In the
future there will also be a way to edit properties from there.
(Unfortunately the version of wxPython I am using has neither the
wxProperty* controls nor wxGrid...)
|