A tutorial HOWTO on using one of the many uses of Pcreole is provided in the third post of this thread.
Pcreole provides a GUI frontend to pretty much ANY bash commandline. You don't need to use it for (wiki)creole mark-up at all (though you may find it very useful as a frontend to creole or txt2tags for that matter... That's one of the things I use it for). Also, you don't need to understand bash commandline at all really; you can just use the "pre-programmed" commandlines provided if you wish. Later on, should you learn bash, you can add to the commandline lists for your own purposes.
Everything tested (without error) on Wary 5.0 (frugal with pfix=ram), but I believe it should work on any recent Puppy (especially now that I've fixed the header line from #!/bin/sh to #!/bin/bash ... and removed the "break" from a case statement... :-), and probably many earlier ones (for example, also tested on Puppy 2.17). Should be a trivial matter to port it to many other Linux distributions too (that's what I'm aiming towards).
Usage/Installation Help:
Use Puppy Manager to remove old versions before installing new ones. Its best to make sure the old Pcreole config folder (~/.pcreole/) is removed before re-installation (though you might like to backup your CMDx_combo and pcreole_xxx.rc config files for re-use if you have altered any of the provided defaults of these for your own uses).
For full functionality install both Pcreole, and nme. (Pcreole itself doesn't depend on nme for anything except for creole mark-up conversion. [Note that you could also use Pcreole as a frontend to txt2tags.py (which is what gave me the original inspiration) if you have that installed and add an appropriate commandline to, for example, CMD0_combo. For example: txt2tags.py -t html "$SF_" -o "$TF_"]
The open source application "nme" was compiled from the original C sources on Wary 5: http://nyctergatis.com/creole/index.html
Note: Pcreole takes a few seconds to start up; especially the first time you run it.
----
Recent Changes:
Pcreole 3.0.3. Removed refs to /root in /etc/pcreole_default.rc; now using $HOME
Pcreole 3.0.2. Changed program logic so that en help button text is always provided by default.
Pcreole 3.0.1. Small gui now "remembers" SD_, SF_, TD_, and TF_ values on QUIT.
Pcreole 3.0.0 provides an alternative for the small graphical user interface option, which I prefer. Functionality is otherwise identical.
Pcreole 2.0.4:
Added necessary header lines in code below to allow internationalisation with gettext to work (Thanks L18L for the information):
Code: Select all
export TEXTDOMAIN=pcreole
export TEXTDOMAINDIR=/usr/share/locale
export OUTPUT_CHARSET=UTF-8
Program: Pcreole (helpfile extract)
(C) Copyright 2011 William McEwan and Emma Caval; GPLv3
(http://wiak.org/ and http://daugdog.com/)
----
Section A: Commandline usage
In a console enter command: pcreole --help
for brief commandline usage.
----
I. Pcreole as a programmable application/bash commandline processing environment:
Pcreole is a programmable application. In effect, Pcreole's main function is to provide a convenient and flexible GUI environment for processing bash commandlines. You don't, however, really 'need' to understand bash or commandlines to use it since many useful commands are already programmed in. Pcreole stores its configuration information in the directory: $HOME/.pcreole/ and includes a powerful facility for Saving and Loading user-created commandline configurations from that or any other storage location. In practice, the way Pcreole works allows it to provide the functionality of many-applications-in-one; a Swiss Army Knife of applications, one might say. Yet all that facility can be controlled with one gtkdialog GUI, with thus very low computer resource usage. The ultraflexible nature of the program means that it may take a bit time and practice to learn its interface, but once its operation is understood, its powerful facilities are very easy to program and use (and should be useful for users experimenting with bash too).
----
II. Pcreole as a hypertext notebook facility:
Amongst its many possible applications, which are limited only by the users imagination, Pcreole provides a hypertext notebook facility. Any number of notebooks can be automatically created. The notes are created as simple text files (which are thus very portable), one note per its own directory, each of which includes a simple navigation bar linking to the other notes in the notebook. Each page of the created notebook utilises simple text-based creole markup and Pcreole also converts that source text automatically into html format, at notebook creation time, using the commandline creole converter "nme". Other document formats can be created from the text-based creole sources using a suitable Pcreole programmed/stored/controlled commandline.
EDIT: Note that you could also use Pcreole as a frontend to txt2tags.py (which is what gave me the original inspiration) if you have that installed and add an appropriate commandline to, for example, CMD0_combo. For example: txt2tags.py -t html "$SF_" -o "$TF_".
----
III. The Operation of Pcreole lends itself to providing GUI frontend control facilities for most any commandline utility or utilities, such as sed, find, grep, awk, ffmpeg, gcc etc.
----
IV. Pcreole can also start up any four user-provided executable scripts or programs via associated buttons on the second row of its main GUI. These user provided executables are required to be named (or link/shortcut name) userprog1, userprog2, userprog3, and userprog4, and need to be stored in its config directory: /root/.pcreole/
---- ---- ---- ---- ----
Read the tool-tip text to better understand how to use Pcreole
All the buttons, checkboxes, and entry areas in both GUIs are provided with tool-tip text, which appears whenever the user hovers the mouse pointer over the item.
----
Tips:
To keep pcreole as the top window, right-click on its window bar, and select Layer -> Top
----
More detailed help information is provided by pressing "HELP" button in Pcreole's main window. A simple tutorial on using Pcreole to convert creole marked-up txt to html is given in the next post. However, Pcreole isn't restricted to that use - it provides a GUI frontend to pretty much ANY bash commandline.
----