szit

Ez az oldal csak olvasható. Megtekintheted a forrását, de nem változtathatod meg. Ha úgy gondolod, hogy ez helytelen, kérdezd az Adminisztrátorokat!
[[oktatas:programozás:programok|< Programok]]

====== Geany ======

  * **Szerző:** Sallai András
  * Copyright (c) Sallai András, 2014, 2015, 2018, 2020, 2021
  * Licenc: GNU Free Documentation License 1.3
  * Web: https://szit.hu
===== A Geanyről =====

A Geany egy több platformos, gyors, sok szolgáltatással bíró, 
több nyelvű fejlesztőeszköz.

A legújabb Geany telepíthető webhelyéről:
  * https://geany.org

Debian GNU/Linux alatt használhatjuk az apt parancsot:
  apt install geany
Bővítmények telepítés:
  apt install geany-plugin*

===== Billentyűkombinációk =====

A teljesség igénye nélkül a leghasznosabb billentyűkombinációk gyűjteménye.

|  Ctrl + E  | Egy sor megjegyzésbe |
|  Ctrl + M  | Sor megjelölése |
|  Ctrl + .  | Ugrás a következő megjelölt sorhoz |
|  Ctrl + ,  | Ugrás az előző megjelölt sorhoz |
|  Ctrl + H  | Csere |
|  Ctrl + I  | Behúzás növelése |
|  Ctrl + U  | Behúzás csökkentése |
|  Ctrl + Shift + M | A kurzor "alatti" szó és azzal azonos szavak megjelölése |

===== snippets =====

A snippets-ek lehetővé teszik, hogy egy rövid kulcsszó beírása
után, a Tabulátor gomb megnyomására beíródjon egy
komplett kódsor. A snippets a fájl kiterjesztéséből tudja,
hogy milyen snippet-t kell használnia, vagyis előbb szükség
van egy mentett állományra a működéshez. 

A snippets beállítások a következő helyen találhatók:

  * Eszközök > Konfigurációs fájlok > snippets.conf

Kiegészítések a snippets beállításokhoz:

<code ini snippets.conf>
[Java]

sout=System.out.println("%cursor%");
serr=System.err.println("%cursor%");
cl=class Névtelen {\n\tpublic static void main(String[] args) {\n\t\t%cursor%\n\t}\n}
sc=Scanner scanner = new Scanner(%cursor%);
is=import java.util.Scanner;

[Javascript]

con=console.log(%cursor%);


[HTML]

html=<!DOCTYPE html>\n<html lang="hu">\n<head>\n\t<meta charset="utf-8">\n\t<title></title>\n</head>\n<body>\n\t<h1>%cursor%</h1>\n\t<p></p>\n\n</body>\n</html>\n
link=<link rel="stylesheet" href="%cursor%">
sc=<script src="%cursor%"></script>
</code>


A rövidítést az egyenlőségjel előtt adjuk meg, utána pedig mit szeretnénk a rövidítésre a forráskódba írni.
A %cursor% mintával megadható, hol legyen a kurzor a beillesztés után.

A rövidítés használata a "Tab" billentyűvel lehetséges.
Írjuk be a rövidítést, majd nyomjuk meg a tabulátor billentyűt.

A következő linken weboldalak készítéséhez találunk kibővített snippeteket:
  * https://gist.github.com/marcusti/98160/0596b9d8697949b391340986b8c548e081ed3823


===== Kódformázás =====

==== AStyle ====

Az AStyle használható pluginként és külső parancsként is. 

Külső parancsként egyszerűen vegyük fel:
  * Szerkesztés -> Formázás -> A kijelölés küldése -> Egyedi parancsok megadása

=== Linux ===

A következőkben áttekintjük az AStyle kódformázó beüzemelését Linux alatt.

Telepítsük a szükséges eszközöket:
  apt install geany make g++ pkgconf libgtk2.0-dev


Le kell töltenünk a Geanyhez az geany-astyle plugint. Egyszerű is lenne, ha
nem forrásban kapnák a Linuxhoz a plugint. 

A plugin beszerzése:
  * https://launchpad.net/geany-astyle

A fenti linken Windows bináris szerezhető be. Linuxhoz a forrást kell használnunk.


A pluginhez szükségünk van az astyle forrására (ez nem a plugin). Ez is beszerezhető a weboldaláról:
  * http://astyle.sourceforge.net/

Ha beszereztük az AStyle forrását csomagoljuk, majd jöhet a fordítás.
Az AStyle kódformázó fordítása:
  cd astyle/src
  cp ../build/gcc/Makefile ./
  make shared

Az astyle/src/bin könyvtárban megtaláljuk a kész libastyle.so fájlt. Ezt másoljuk a
/usr/lib könyvtárba.

  cp bin/libastyle.so.3.1.0 /usr/local/lib
A verziószám eltérhet a fentiektől. Készítsünk egy szimbolikus linket,
ugyanazon néven, de a verzió ne tartalmazza:
  cd /usr/local/lib
  ln -s libastyle.so.3.1.0 libastyle.so.3


Ez után lefordíthatjuk a plugint. Lépjünk be a plugin könyvtárába:
  cd astyle-plugin-src-0.2.1/src

Készítsünk Makefile-t vagy csak egyszerűen írjuk be:
  gcc main.c -O2 -fPIC `pkg-config --cflags geany` \
  -lastyle -shared `pkg-config --libs geany` -o "astyle_plugin.so"

Elkészült az astyle_plugin.so fájl, amit be kell másolnunk a Geany plugin könyvtárába.
  cp astyle_plugin.so ~/.config/geany/plugins/


Megjegyzés:
A libastyle.so fájl fordítás nélkül, csomagból is telepíthető,
de használatához szükséges egy szimbolikus link:
  apt install libastyle-dev
  ln -s /usr/lib/x86_64-linux-gnu/libastyle.so /usr/local/lib/libastyle.so.3



=== Windows ===

Windowsra nem szükséges a fordítás, mert van bináris fordítva a plugin weboldalán:
  * https://launchpad.net/geany-astyle

Töltsük le a Windowsos plugint, majd másoljuk libastyle.dll és az astyle_plugin.dll fájlokat
például a Geany könyvtárába:
  * libastyle.dll -> C:/Programs/Geany/bin
  * atyle_plugin.dll -> C:/Programs/Geany/lib)
=== Használat ===

Az AStyle plugin alapértelmezetten nincs bekapcsolva. 
A következő helyen tudjuk aktiválni:
  * Eszközök -> Bövítménykezelő

Az előugró ablakban kattintsunk az AStyle jelölőnégyzetére. 
Bekapcsolás után az Eszközök menüben egy új menüpont jelenik meg: AStyle.
Ha szeretnénk használni, csak egyszerűen kattintani kell.


===== Témaváltás =====

A geany könyvtárban a filedefs alkönyvtárat nevezzük át például filedefs_eredeti névre,
vagy mentsük el valahova. Töltsük le a kívánt témát, majd másoljuk az eredeti filedefs
helyére a téma filedefs könyvtárát.

  * https://github.com/joelhy/geany-vibrant-ink-theme

Másik lehetőség: Színsémákat innen tölthetünk le:
  * https://github.com/geany/geany-themes

A projekt colorschemes könyvtárából másoljuk a .conf kiterjesztésű fájlokat a 
colorschemes könyvtárba. Linux ez:
  ~/.config/geany/colorschemes

A színséma ezek után a következő menüből választható:
  * Nézet -> Színsablon cseréje ...

===== Sablonok készítése =====
==== A sablonok helye ====

A sablonok a következő helyen érhetők el:
  Fájl -> Új (Sablonból) -> 

Egy új sablonnal kezdeményezhetünk egy adott nyelven egy Helló Világ nevű programot.
Magunk is készíthetünk sablonokat. 

Készítsük el a kívánt sablont egy egyszerű szöveges fájl formájában. 
Mentsük, illetve másoljuk a geany könyvtár templates/files alkönyvtárába.

Linux alatt a felhasználók a következő helyen találják:
  ~/.config/geany/templates/files/

W7 alatt egy joska nevű felhasználó esetén:
  c:\users\joska\AppData\Roaming\geany\templates\files\

Figyeljünk arra, hogy az AppData egy rejtett könyvtár.

XP alatt egy joska nevű felhasználó esetén:
  c:\Documents and Settings\joska\Application Data\geany\templates\files\


==== Java Swing sablon ====

<code java Program01.java>
import javax.swing.JFrame;

class Program01 extends JFrame {
	Program01() {
		
		setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
		setSize(400, 300);
		centerWindow(this);
		setVisible(true);
	}
	public static void centerWindow(java.awt.Window frame) {
		java.awt.Dimension dimension = 
                    java.awt.Toolkit.getDefaultToolkit().getScreenSize();
		int x = (int) ((dimension.getWidth() - frame.getWidth()) / 2);
		int y = (int) ((dimension.getHeight() - frame.getHeight()) / 2);
		frame.setLocation(x, y);
	}	
	public static void main(String[] args) {
		new Program01();
	}
}
</code>
===== Tags fájlok =====

A tags fájlok lehetővé teszik az ismert osztályok, metódusok, stb. kiemelését, kiegészítését.

Tags fájlok letölthetők például a következő helyről:
  * http://wiki.geany.org/tags/start

Néhány nyelvhez felelhető tags fájl generátor is. Például Java nyelvhez:
  * http://download.geany.org/contrib/tags/

W7 alatt a következő helyre kell másolni:
  c:\Users\User\AppData\Roaming\Geany\tags\

==== Kézzel írt tag fájlok ====

Például JavaScripthez:
<code javascript geany/tags/sajat.js.tags>
console.log()
console.info()
document.getElementById()
document.getElementsByTagName()
document.getElementsByClassName()
document.write()
alert()
prompt()
confirm()
</code>

===== Lua script =====

A Geany lua nyelven scriptelhető. 
A Lua scriptekhez nem kell telepítve legyen lua az operációs rendszeren,
de szükség van a geany-plugin-lua pluginre. Debian alatt telepítés:
  apt install geany-plugin-lua


A Lua scripteket viszont engedélyezni kell a következő helyen:
  * Eszközök -> Bővítménykezelő
A bővítmény oszlopban keressük ki a "Lua Script" sort, majd az "Aktív"
oszlopban jelöljük be a jelölőnégyzetet.

Windows esetén töltsük le a kiegészítő bővítményeket:
  * https://geany.org/download/releases/
==== Scriptek helye ====

Linux alatt a scripteket a következő helyre kell tenni:
  ~/.config/geany/plugins/geanylua/

Windowson:
<code>
c:\Users\janos\AppData\Roaming\geany\plugins\geanylua\
</code>


A plugins/geanylua könyvtárak, ha nem léteznek, hozzuk létre őket:
  mkdir -p ~/.config/geany/plugins/geanylua/

Windowson:
<code>
mkdir c:\Users\janos\AppData\Roaming\geany\plugins\geanylua\
</code>

==== Scriptek indítása ====

A scripteket indíthatjuk menüből vagy billentyűkombinációval.

A billentyűkombinációk két módon indíthatók:
  * hotkeys.cfg fájlból
  * a script első sorába írjuk a billentyűkombinációt

=== hotkeys.cfg ===

Írjuk a script útvonalát, névvel együtt hotkeys.cfg fájlba. 
A script útvonala lehet abszolút, vagy relatív a 
/plugins/geanylua/ könyvtárhoz képest. 

<code cfg hotkeys.cfg>
scriptneve
</code>


=== A script első sora ===
Elavult verzió, ha a script első sorába írjuk a billentyűkombinációt.

<code lua script.lua>
-- @ACCEL@ <Control><Shift>j

</code>


==== Beszúrás a szerkesztőbe ====

Készítsük el például a oraKezd.lua állományt:
  mcedit ~/.config/geany/plugins/geanylua/oraKezd.lua

<code lua script01.lua>
-- @ACCEL@ <Control><Shift>j

geany.selection("\n====================\n\n")
geany.selection(os.date("%Y-%m-%d"))
geany.selection("\n\nÓra:\nTéma:\nHiányzók: \nDolgozat: \n\n");

</code>

Megjegyzés: Ügyeljünk arra, hogy az <nowiki>-- @ACCEL@</nowiki> kezdetű sor előtt nem lehet üres sor.


Ez a script mindig beszúr 20 egyenlőségjelet, majd a dátumot és még
négy sor szöveget a szerkesztőbe. A script elején billentyűkombinációt is
megadtam a scriptben, így az indítható a Ctrl+Shift+j billentyűkombinációval,
vagy Eszközök menü, "Lua Scripts" menüpont alatt. 


==== HTML wrapper ====

<code lua ~/.config/geany/plugins/geanylua/htmlWrapper.lua>
-- @ACCEL@ <Alt>w
 
sor = geany.selection()
elem = geany.input("Elem neve:")
geany.selection("<" .. elem .. ">" .. sor .. "</" .. elem .. ">")
</code>


==== Kapcsolódó linkek ====

  * https://plugins.geany.org/geanylua/geanylua-index.html
    * https://plugins.geany.org/geanylua/geanylua-ref.html
    * http://plugins.geany.org/geanylua/geanylua-intro.html
  * http://www.lua.org/manual/5.1/manual.html



===== Böngésző frissítése távolról =====

Ha a böngészőben meg van nyitva egy weblap, amelyet szerkesztünk,
szeretnénk a mentés pillanatában frissíteni a weblapot. 
Ezt egy Lua scripttel fogjuk megvalósítani Linux alatt.
Linux alatt a xdotool programot használjuk. Ha van ilyen program
Windowsra, akkor ott is megvalósítható.

Google Chrome ablak frissítése parancssorból:
  xdotool search --onlyvisible --class chrome windowfocus key ctrl+r

Vivaldi ablak frissítése parancssorból:
  xdotool search --onlyvisible --class chrome windowfocus key ctrl+r

Egy Lua scriptben is végrehajtható:

<code lua>
geany.launch("/usr/bin/xdotool",
	 "search",
	 "--onlyvisible",
	 "--class", "chrome",
	 "windowfocus",
	 "key",
	 "ctrl+r")
</code>

Előbb mentsük a dokumentumot:
<code lua>
geany.save()
geany.launch("/usr/bin/xdotool",
	 "search",
	 "--onlyvisible",
	 "--class", "chrome",
	 "windowfocus",
	 "key",
	 "ctrl+r")
</code>

Teljes script:
<code lua>
-- @ACCEL@ <Control><Shift>h

function contains(array, val)
	for i=1,#array do
		if array[i] == val then
			return true
		end
	end
	return false
end

exts = {".php", ".html"}
actFileExt = geany.fileinfo().ext

if contains(exts, actFileExt) then
	geany.save()
	geany.launch("/usr/bin/xdotool",
	 "search",
	 "--onlyvisible",
	 "--class", "chrome",
	 "windowfocus",
	 "key",
	 "ctrl+r")	
end
</code>

A Script a <Ctrl>+<Shift>+<H> billentyűkombinációval indítható. 
A billentyű aktiválásához szükség van a Geany újraindításához.
Ha a script utasításait változtatjuk, akkor nem szükséges az újraindítás.

===== HTML kódgenerátor =====

==== Telepítés ====

  * Töltse le a scriptet a geany/plugins/geanylua könyvtárba
  * Készítsen egy geany/plugins/geanylua/hotkeys.cfg fájlt
    * Tartalma:
    * emma.lua
  * Indítsa újra a Geany-t
  * Állítson billentyűkombinációt a scripthez:
    * Szerkesztés > Beállítások > Billentyű hozzárendelések 
    * Keresse a Lua Script résznél: Emma
    * Lehetséges billentyűkombináció: Alt+q

==== Letöltés ====

  * https://szit.hu/download/emma.lua
==== Használat ====

Ha Alt+q billentyűkombinációt állított be:

<code html>
ul>li*4
</code>
A beírt szavak után nyomja meg a Alt+q billentyűkombinációt. 


===== Bővítmények =====

Debian GNU/Linux alatt telepíthető bővítményeket így tekinthetjük meg:
  apt search geany

Windowsra a bővítményeket letölthetjük a Geany weblapjáról:
  * https://geany.org/download/releases/


Windows alatt bővítmények helye:
  c:\Users\janos\AppData\Roaming\geany\plugins\

Telepítővel a következő helyre kerülnek a bővítmények:
  c:\Program Files (x86)\Geany\lib\geany\

=== Bővítmény aktiválása ===

A feltelepített bővítményeket aktiválni kell. 
  * Eszközök > Bővítménykezelő

Néhány ajánlás:
  * [✔] Ablak felosztása
  * [✔] Lipsum
  * [✔] Lua Script
  * [✔] Spell Check
  * [✔] TreeBrowser
  * [✔] Web helper
  * [✔] XML Snippets

===== Hasznos beállítása =====

Néhány hasznos beállítás:

  * Szerkesztés > Beállítások
    * Általános > Egyéb > "A projekt alapkönyvtárába mentse a projekt fájlt
    * Fájlok > Kódolások > "Alapértelmezett kódolás (új fájlok): Unicode (UTF-8)
    * Terminál > [✔] "Az aktuális fájl elérési útjának követése


===== Néhány megoldás Linuxon =====

  * [[oktatas:linux:apró_debianos_tippek&#geany_és_a_mate-terminal|Geany és Mate-terminal]]
  * [[oktatas:linux:grafikus_feluelet:geany|Linux grafikus felüelt Geany]]