179 lines
5.6 KiB
HTML
Raw Normal View History

2016-11-25 00:33:18 -07:00
<!DOCTYPE html>
<html lang="en">
<head>
<title>README</title>
<link rel="stylesheet" href="../documentation/style.css" type="text/css">
</head>
<body>
<header>
<img src="../thumbnails/gtk-logo-rgb.gif" alt="GTK Logo">
<img src="../thumbnails/mongoose.png" alt="OpenEuphoria Logo">
<h1>EuGTK 4.11.10</h1>
<h2 class='blue'>Programmer's Resources</h2>
</header>
<h2 class='red'>Editors</h2>
<h3>WEE</h3>
<p>
I now use Pete Eberlein's WEE editor frequently, since it is cross-platform and designed for Euphoria source code.<br />
<ol>
<li>Create a folder called "Wee"</li>
<li>Download <a href="https://github.com/peberlein/WEE/raw/master/updater.ex">
https://github.com/peberlein/WEE/raw/master/updater.ex</a></li>
<li>Run "eui updater.ex" to download/update the files for your platform.</li>
<li>Run "eui wee" to run the editor, or compile/bind/shroud it for convenience.</li>
</ol>
To set up [F1] key pop-up GTK help, follow <a href="../documentation/README.html#weemods">these directions.</a></li>
</p>
<hr />
<h3>Geany, gedit, pluma, GtkSourceView, etc...</h3>
<p>
In this folder are files which will add
Euphoria and EuGTK syntax highlighting to editors above, and one-click run or compile capability to
Geany.
</p>
<pre>
To Install:
<u>For programs using GTK2 -- i.e. Geany, Pluma, etc.</u>
sudo cp euphoria.lang /usr/share/gtksourceview-2.0/language-specs/euphoria.lang
sudo cp gedit_syntax.xml /usr/share/mime/packages/
sudo cp classic.xml /usr/share/gtksourceview-2.0/styles/
<u>For programs using GTK3 -- i.e. EuGTK Sourceview</u>
sudo cp euphoria.lang /usr/share/gtksourceview-3.0/language-specs/euphoria.lang
sudo cp gedit_syntax.xml /usr/share/mime/packages/
sudo cp classic.xml /usr/share/gtksourceview-3.0/styles/
Actually, it doesn't hurt to do both :)
<u>Optional, if you prefer these styles:</u>
sudo cp cobalt.xml /usr/share/gtksourceview-2.0/styles/
sudo cp oblivion.xml /usr/share/gtksourceview-2.0/styles/
sudo cp build.xml /usr/share/gtksourceview-2.0/styles/
sudo cp cobalt.xml /usr/share/gtksourceview-3.0/styles/
sudo cp oblivion.xml /usr/share/gtksourceview-3.0/styles/
sudo cp build.xml /usr/share/gtksourceview-3.0/styles/
</pre>
<p>
For Geany, enter the location of your GTK documentation in Geany's <i> context-action-cmd </i>
accessed from the menu: Edit=>Preferences=>Tools=>Commands
</p>
<div class="quote">
<p>Example:<br />
<code>
context_action_cmd=firefox -new-tab file:///home/irv/gtk3/%s.html
</code>
</p>
</div>
<p>
Once that's done, you can pop up docs on GtkWidgets in
your Euphoria source code. Highlight the widget name, e.g. <u>GtkWindow</u>, then right-click and choose context action.
You could also set up a geany keybinding for this, such as alt-i.
In the example above, you may prefer to use -new-window instead of -new-tab,
or perhaps -search in order to use your default on-line search engine.
</p>
<div class="hint">
<img class="hint" src="../thumbnails/hint.png" alt="hint" width="100px" align="left" float="right" />
<p>
If you are connected to a local network, but <i>not</i> the internet, links in the GTK docs may
try to load images, etc from off-site. This will slow or stop you from getting the help you need.
</p>
</div>
<hr />
<h3>GtkSourceView</h3>
<p>
Gtk has its own editor, with syntax highlighting for over 100 programming languages,
which now works as a EuGTK plugin (see <a href="../test201.ex">test201.ex</a>. With
EuGTK 4.11.3, I'm now using this for most editing tasks. It uses the syntax
highlighting files shown above for GTK3.
</p>
<p>The GtkSourceView editor is also used in <a href="../BEAR.ex">Bear.ex</a>,
which can edit and test run source code as well as view and edit html pages.
</p>
<hr />
<h3>Glade</h3>
<p>
You can use Glade to visually (drag and drop) design your interface. You'll still need to write some
'glue' code to link signals to Euphoria functions, just as you would with VisualBasic&trade;, etc., so a text
editor such as WEE will still be necessary. See <a href="../documentation/Glade.html">Glade.html</a>.
</p>
<hr />
<h4>Other files here</h4>
<p>
<ul>
<li><a href="themeicons.txt">themeicons.txt</a>
<dd>this is generated by <a href="../examples/icons.ex">icons.ex</a>, and lists the names of icons
available in the current theme.</dd>
</li>
<li><a href="xcolors.txt">xcolors.txt</a>
<dd>this is a list of color names generated by xcolors, in case you
don't have xcolors or access to the web.</dd>
</li>
<li><a href="papersizes.txt">papersizes.txt</a>
<dd>a list of paper size names for possible use when setting up a print process.</dd>
</li>
<li><a href="words.txt">words.txt</a>
<dd>21,084 english words used by the hangman demo.</dd>
</li>
<li><a href="notebook_pages.txt">notebook_pages.txt</a>
<dd>content for <a href="../test155.ex">test155.ex.</a></dd>
</li>
<li>colorcode folder
<dd>contains resistor images created by me using Gimp.</dd>
</li>
<li>flags folder
<dd>contains 247 flags, all in the public domain.</dd>
</li>
<li>gedit_syntax folder
<dd>contains Mario Steele's color coding for GEdit, Pluma, and GtkSourceView.</dd>
</li>
<li>*.css files
<dd>various css files to support demos</dd>
</li>
</ul>
</p>
<footer>
<div class="hint">
<img class="hint" src="../thumbnails/mongoose.png" alt="hint" align="left" float="right" />
<p>
This page edited by The <a href="../documentation/README.html#bear">Bear</a>,
a web-page and programming editor
written in <a href="OpenEuphoria.org">Euphoria</a>.
</p>
<p>
Updated for EuGTK version 4.11.11 Sept 1, 2016<br />
All code &copy; 2016 by Irv Mullins
</p>
</div>
</footer>
</body>
</html>