https://github.com/as400jplpc/zig-helix
Installation environnement ZIG and ZLS and HELIX
https://github.com/as400jplpc/zig-helix
Last synced: about 1 year ago
JSON representation
Installation environnement ZIG and ZLS and HELIX
- Host: GitHub
- URL: https://github.com/as400jplpc/zig-helix
- Owner: AS400JPLPC
- Created: 2023-09-21T23:05:54.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2025-02-28T20:23:08.000Z (over 1 year ago)
- Last Synced: 2025-02-28T23:33:53.477Z (over 1 year ago)
- Language: HTML
- Homepage:
- Size: 18.9 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
**Helix**
**2023-10-24 Normally, I finished debugging all the scripts and made it flexible to use.**
_After a few problems... & a few scares..._
_I switch from VSCode ide to helix-editor_
_I need an editor, maybe less plugin...,_
_but it does exactly what I ask it to do._
Setting up Helix, I work with Linux, you will find in your distribution how to install it.
To develop, it is better to have an installation of ZIG / ZLS, in your HOME, think about changing the version, this allows you to test more easily
https://helix-editor.com/
a) install Zig https://ziglang.org/download/
b) install Zls LSP [https://github.com/zigtools/zls](https://github.com/zigtools/zls)
c) install lldb (pacman -S lldb) for manjaro or arch include lldb-vscode recommend for Helix and ZIG
d) _Look at the “enScript” folder: a module to list your source files on the printer_ (pacman -S enscript)
c) **I provide a set of small BASH procedures (which are very simple, modifiable as desired). This will give you a lot of flexibility**
d) A tool is available to you TermHx a small 23kb terminal
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
personally I put Zig in ./zig and zls in ./zls
in .profile
add matching paths and aliases
```plaintext
export PATH=/home/soleil/.zig:$PATH
export PATH=/home/soleil/.zls:$PATH
```
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
.config/helix/
config.toml file concerns the editor settings
After searching and gathering the most important and cool points
I thank the various authors...
tested and bug-free
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
mytheme.toml
origine (dark\_plus) very few modifications "|" for the indentation { }...
a note in config.toml
I put the relationship.
theme = "mytheme"
copy mytheme to /usr/lib/helix/runtime/themes/
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
.cache/helix.config/helix
cache/helix → Contains helix.log and archiveFile.log
.config/helix →Contains config.toml , langage.toml , mytheme.toml
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
ZIG project my architecture
|Docs | |Print| |src-c|library |src-zig| |binary |
|-----|-|-----|-|-----|--------|-------|---|-------|
| | | | |Term | curse |Gencurs| |Gencurs|
| | | | | | lib |deps | | |
| | | | | | decimal| | | |
| | | | | | | | | |
Zterm → Contains compiled binary programs and Folders
Docs → build-docs
Print → Contains Docs source
src-c → source C/C++
libray → source zig Contains folders import
curse → Contains source import
lib → source.h ex: link libpcre2-posix.so
decimal → source import link mpdecimal.so
or
deps → Contains folders import
curse → Contains source import
lib → source.h ex: link libpcre2-posix.so
decimal → source import link mpdecimal.so
src-zig → Contains source and build, folders( library, deps, lib )
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
This is an example of an environment :
for me: using Zig-lang, I configured it and I no longer have link errors with LSP and the language is well recognized.
Now the tools to compile and a console.
My compilation tools are pretty much the same as VSCODE and task.
I have a ".Terminal" folder in which the procedures are located
_**I only use the terminal ex: xfce4-terminal**_
EnvZig.sh
```plaintext
compile: zig build / doc ....
1. ClearProjet (only cache compile )
2. Compile_Debug
3. Compile_Prod
4. Compile_Safe
5. Compile_Small
6. Compile_test
7. Compile_Doc
```
The compilations are done with a build which allows a lot of flexibility and incorporates all the settings
EnvCPP.sh
```plaintext
compile: gcc... c/c++
1. ClearProjet
2. Compile_Debug
3. Compile_Prod
```
The compilations are done with a Makefile which allows a lot of flexibility and incorporates all the settings
MenuDEV.sh
```plaintext
Langage-ZIG-LANG - Project: .....
------------compile cpp-----------------
1. Terminal-Gen
------------compile Zig-----------------
11. Gencurs
12. app/module
13. study
----------------------------------------
33. Debug LLDB
44. enScript Printer
55. Edit my project
66. Edit last source used
77. clear helix.log
88. Console
99. Exit
```
1 → Secure terminal for a Client application
11 → ex: Code generator from a designor
12 → Module under test for integration with Gencurs
13 → Learning the ZIG language
33 → debeugeur LLDB
44 → List of your print-ready source files
50 → Opening Helix --default-working-directory PROJECT/library
55 → Opening Helix --default-working-directory PROJECT/src-zig
66 → Opening Helix: searches for the latest record in ".cache/helix/archiveFile.log"
77 → cleaning the helix.log file
88 → Opening Standard console simulation for customer application testing or other
When you are in the Helix environment:
**To retrieve the latest source, you have to A-q keymap (Alt-q)**
**please look at the config.toml please**
```plaintext
Path :/home/soleil/Zterm/src-zig
q = exit
----------------------------------------
Name source : mdlRjson.zig
```
Archive the source: date Time path name allows you to have a follow-up and gives the possibility of opening the last source on which you were.
Recording in the ".cache/helix/archiveFile.log" example
"2023-09-25 20:54:12 file:///home/soleil/Zterm/src-zig/Gencurs.zig"
At the moment we do not have access to the file name to include directly in archiveFile etc..
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
option 33 : debugZig.sh
Pacman -S lldb package includes ( ldb - lldb-argdumper - lldb-instr - lldb-server - lldb-vscode )
```plaintext
PID ?
q = exit
```
The script runs in a separate window "pkexec (sudo) lldb attach PID"
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
option: 44 enScript form source to printer
look folder enscript
```plaintext
Path :/home/soleil/Zterm/
q = exit
----------------------------------------
Path source : src-zig
Name source : mdlRjson.zig
----------------------------------------
Paper Size ; A4 / A3 / Letter
Size : A3
```
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
Coming back to the difference between VSCODE and HELIX
is that I had direct action from VSCODE,
because there is no integrated terminal or possibility of communication from helix and program. RUST security.
But the LSP is meaner than on vscode, so we find it.
The learning curve is relatively uncomplicated than vim... on the other hand, you have to take the time to practice the tutorial.
The gain: no more madness in the propagation of caches and various logs and memory extension.
The gain: no more madness in the propagation of caches and various logs and memory extension.
I've done quite a few tests of neovim by the way, gvim, kakoune, lite-xl, geany, codeblock, sublime, atom, builder, and a few others, I think this one is the right one, it's still missing one or two things, but not vital.
start informatique 1976 middle systeme
my big stops on PC since 1985
Metroworks CodeWarrior. trubo pacal etc.
codeblock, my first more than 25 years ago,
geany, has been my utility for a long time
builder, my sewing machine
vscode ......... in short, I keep it stanbye. (this was a serious advance on PC as a code editor)
more than 50 years ago IBM was 50 years ahead and the LSP was integrated but proprietary
\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_
so HELIX is small in size, but does a good job
**After working, and spending some time to find the configuration tips, "copy/paste" the most coherent theme, e.g.: brackets and adjustment of the language definition etc. It's starting to be effective**
Lorenzo Sétale and Rajasegar Chandran thank-you
I'm working with "helix" and restructuring my sources, because I encounter the end of line positions and spaces are completely inconsistent.
We can't really do without visualizing spaces, and colors can quickly become inconsistent and unpleasant.
* I think that there, I will stabilize.
helix --health zig
Configured language server: zls
Binary for language server: /home/soleil/.zls/zls
Configured debug adapter: lldb-vscode
Binary for debug adapter: /usr/bin/lldb-vscode
Highlight queries: ✓
Textobject queries: ✓
Indent queries: ✓
2023-09-22 **Testing**
* new mytheme : comes from dark\_plus > vscode
* update langage.toml and config.toml
There is very little action on the settings already in place, so let it be and opt for the minimum authorized (less inconsistency with Hélix)
* During an update of VSCODE, the settings changed and my source files became a real hassle. You can resume, with for example "mousepad" a word processor where all the characters are displayed and change the points to tabulation etc. Be careful, you have to go there with little slippers.
* The debug mode with HELIX is experimental, it does not work completely, for example, we do not obtain the value of the variables in the submodules in a clear way. With the LLDB program you have a complete mode, lldb-vscode is a derivative of lldb But it's strictly the same with VSCODE. lldb: it is possible to use GUI order (tui) to have an overview Point at objects etc... in console mode and follow step by step
* **Saving the name of your current work with "Alt-q" removing "file:///home…" the ABSOLUTE PATH ONLY “file:/home…”**
* 2023-10-20 _**important possibility:**_
```plaintext
Consideration of a mini Terminal based on the VTE3 library.
More security (no "close" button) only ALT-F4 or normal closing of the "Helix" editor.
Very light. TermHx 8mo actif
Font "Noto Sans Mono".
We obtain the same rendering as "xfce4-terminal".
Possibility of having several working sessions (attention LSP will suffer).
No more keys to configure in the terminal
All keyboard keys are available. Except Alt-F4
```
* For those who want to keep the traditional terminal system: bash\_lastFile.sh and bash\_myProject.sh.
* the terminal is located in the src-c folder TermHX.cpp and the Makefile
* modification config.toml
“auto-save”. Example, you want to compile by changing the window focus automatically, saving your source is done.
"auto-signature-help" = false. LSP is still in development, the overhead is painful. (idem avec VSCODE)
#bufferline = "multiple", Easier to get started. With multiwindowing, buffers etc.
* 2023-10-24
helix dissociation and menu\_dev (_**real session**_) **more HELIX scratch session**
compilation menu test -ZIG with errors returning / the size and movement of the binary in the main directory
Cleaning the cache/out directory
How to name your sources
source = name.zig
buildefile = buildname.zig
```plaintext
ex: option 2 debug
Compile_Debug
+ zig build --build-file /home/soleil/Zterm/src-zig/buildExemple.zig
BUILD DEBUG Exemple.zig -> /home/soleil/Zterm/Exemple size : 2,6M
Press[Enter] key to continue
ex option 7 doc
Compile_Doc
+ zig build docs --build-file /home/soleil/Zterm/src-zig/buildExemple.zig
/home/soleil/Zterm/src-zig/Docs_Exemple
BUILD DOCS Exemple.zig -> Docs_Exemple
Press[Enter] key to continue
an example buildExemple.zig
```
---
---
I am at the same level (VSCODE) code editor with more flexibility and security
* tip: when you study.
if you need a copy and paste from an external source make a source
ex: A\_copy.zig in your HELIX session with your program made vnew spacebar F choose A\_copy go to https://zigbyexample.github.io/
copy a source then open A\_copy (mousepad or other) copy again (paste) on your reload session etc...
It looks complicated, but it actually goes very quickly
* 2023-12-04.
update lastfile.zig **if the file does not exist in the project return**
* 2023-12-26 add folder TerminalHX **terminal vte gtk3 for Helix**
* 2023-12-26 delete message nohup from option 55/66 menu-dev
* 2023-12-28 **out of service CTRL-Z with the "vte" terminal "TermHX"**
* 2024-02-25 Adjustment of procedures, an "example" file will help you implement. The TermilaHX folder will allow you to have a VTE3 terminal freed from all keys except ALT-F4 and CTRL-Z by default.
* 2025-01-05 clear cache
---
---
astuce:
I have provided you with two files as examples to make your life easier:
a) compile_zig_exemple, which displays the menu for compilation.
b) menu_Dev_exemple, which displays the general menu.
In the ./config/helix/ directory, I have added a few lines that simplify things.
[keys.normal]
C-n = ["file_picker_in_current_directory"] # Maps Ctrl-n split new vertical get feil dir
C-s = ":w"
C-c = ["yank_main_selection_to_clipboard"]
C-v = ["replace_selections_with_clipboard"]
// Example: Specification for the 'Gencurs' project
# create a new minor mode bound to `+`
[keys.normal."+"]
m = ":sh gnome-terminal --title='Menu-General...' --hide-menubar -- ../MenuDEV.sh && exit"
g = ":sh gnome-terminal --title='Compile-Gencurs' --hide-menubar -- ../Compile_Zig.sh 'Gencurs' && exit"
h = ":sh gnome-terminal --title='Compile-Gensrc.' --hide-menubar -- ../Compile_Zig.sh 'Gensrc' && exit"
x = ":sh gnome-terminal --title='Compile-mdlsrc.' --hide-menubar -- ../Compile_Zig.sh 'mdlSrc' && exit"
w = ":sh gnome-terminal --title='Enr.Memoire(66)' --hide-menubar -- $HOME/.Terminal/copyZig.sh && exit"
c = ":sh $HOME/.Terminal/console.sh && exit"
which allows you to envy nothing of VSCODE anymore.
* 2024-02-17 Adjustment of procedures
Introduction of the concept of "library"
Improved support for a project
Today, I prefer compiling the "Helix" project because it allows me the opportunity to hack the "KEYMAP" file (...helix/helix-term/src/keymap/default.rs). I have removed a good number of commands to keep only the essential ones.
I reverted to using the basic setup for "ZIG" and adopted the "dark_plus.toml" theme.
I added to the "thermHX" program in "C/C++" the prohibition of CRT-Z, which suspends and clears the terminal by default.
* 2024-03-18 Adjustment of procedures
prerequis:
first compile helix:
```
cd $HOME
git clone https://github.com/helix-editor/helix
cd helix
cargo install --path helix-term --locked
cp contrib/Helix.desktop ~/.local/share/applications
creer dossier /.local/share/icons
cp contrib/helix.png ~/.local/share/icons
```
my keyamp ~/.config/helix/default.rs
simple usuel
clean config.toml
add MgetZig.sh MgetZls.sh MgetHelix.sh
change keymap:
I left all the menus as they were
"mode normal only":
"del" => delete_char_forward,
"up" => move_visual_line_up,
"down" => move_visual_line_down,
"left" => move_char_left,
"right" => move_char_right,
"pageup" => page_up,
"pagedown" => page_down,
"home" => goto_line_start,
"end" => goto_line_end_newline,
"ret" => insert_newline,
":" => command_mode,
"i" => insert_mode,
"A-d" => delete_selection,
"A-r" => change_selection,
"%" => select_all,
"x" => extend_line_below,
"X" => extend_line_above,
"/" => search,
"?" => rsearch,
"n" => search_next,
"N" => search_prev,
"*" => search_selection,
"u" => undo,
"U" => redo,
"c" => toggle_comments,
"Q" => record_macro,
"q" => replay_macro,
">" => indent,
"<" => unindent,
"A-," => remove_primary_selection,
"h" => hover,
"esc" => normal_mode,
"mode insert only":
"esc" => normal_mode,
"tab" => insert_tab,
"S-tab" => unindent,
"del" => delete_char_forward,
"backspace" => delete_char_backward,
"up" => move_visual_line_up,
"down" => move_visual_line_down,
"left" => move_char_left,
"right" => move_char_right,
"pageup" => page_up,
"pagedown" => page_down,
"home" => goto_line_start,
"end" => goto_line_end_newline,
"ret" => insert_at_line_start,
"mode merge only":
"n" => extend_search_next,
"N" => extend_search_prev,
"home" => extend_to_line_start,
"end" => extend_to_line_end,
"esc" => normal_mode,
* 2024-03-21 mineur update option clear => EnvZig / EnvLibZig / MgetHelix
* 2024-03-29 mineur update option clear => Mctrl-Zig-Zls.sh MgetZig.sh MgetZls.sh I anticipated the possibility of a level error between Zig and Zls... Please use Mctrl-Zig-Zls.sh
* 2024-03-31 folder icons for zig to linux
* 2024-04-18 update config.toml
* 2024-07-15 update change exf4-terminal gnome-terminal
* 2024-07-15 update EnvlibZig.sh EnvZig.sh
* 2025-01-04 clear full cache
* 2025-01-04 Simplification of commands like crtl-c copy etc...
* 2025-02-16 udpate HELIX
```
Hello, the new version of HELIX has been released. It allows you to clean up the function keys and add or rather transfer them to config.toml.
As a result, I only use HELIX for ZIG.
It's very efficient, and leaves very few errors.
What I'm looking for in an editor is something simple. I don't like a multitude of function keys, which are useless, confusing and cause malfunctions.
I'm going to update my helix project in Github and Codeberg.
ps(please wait a day)
Translated with DeepL.com (free version)
* 2025-02-28 udpate HELIX file config.toml default.rs purge
```
exemple:
```
[keys.normal]
C-a = [":vnew",":open /home/soleil/Zsnipset"]
C-s = [":write"]
C-c = ["yank_main_selection_to_clipboard"]
C-v = ["replace_selections_with_clipboard"]
C-l = [":clear-register"]
C-d = ["delete_selection"]
C-u = ["undo"]
C-r = ["redo"]
C-t = ["toggle_line_comments","move_line_down"]
C-h = ["hover"]
A-i = ["insert_at_line_start"]
A-e = ["insert_at_line_end"]
A-m = ["match_brackets"]
A-d = ["goto_next_diag"]
A-D = ["goto_first_diag"]
A-f = ["file_picker_in_current_directory"]
A-F = ["file_picker"]
A-n = ["vsplit_new"]
A-v = ["vsplit"]
A-q = ["search"]
A-g = ["goto_last_line"]
[keys.insert]
C-s = ["normal_mode",":write"]
C-c = ["yank_main_selection_to_clipboard"]
C-v = ["replace_selections_with_clipboard"]
C-l = [":clear-register"]
C-d = ["delete_selection"]
C-u = ["undo"]
C-r = ["redo"]
C-t = ["toggle_line_comments","move_line_down"]
C-h = ["hover"]
A-m = ["match_brackets"]
A-d = ["goto_next_diag"]
A-D = ["goto_first_diag"]
```