From f0b9241796586eb854d8c1f15fb4ed227a434f6c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20T=C3=A1mara?= Date: Tue, 4 Nov 2025 18:21:12 -0500 Subject: [PATCH 1/6] Added symbols for insstallation section --- assets/css/webfont.css | 18 ++++++++++++++++++ assets/fonts/SymbolsNerdFontMono-Regular.ttf | Bin 3564 -> 5800 bytes contrib/symbolnerdfontmonolist.txt | 6 ++++++ 3 files changed, 24 insertions(+) diff --git a/assets/css/webfont.css b/assets/css/webfont.css index a16ee5e..7b89cc5 100644 --- a/assets/css/webfont.css +++ b/assets/css/webfont.css @@ -55,3 +55,21 @@ .nf-oct-kebab_horizontal:before { content: "\uf4eb"; } +.nf-dev-windows:before { + content: "\ue70f"; +} +.nf-linux-tux:before { + content: "\uf31a"; +} +.nf-linux-apple:before { + content: "\uf302"; +} +.nf-linux-freebsd:before { + content: "\uf30c"; +} +.nf-oct-terminal:before { + content: "\uf489"; +} +.nf-fa-folder_tree:before { + content: "\uef81"; +} diff --git a/assets/fonts/SymbolsNerdFontMono-Regular.ttf b/assets/fonts/SymbolsNerdFontMono-Regular.ttf index 57301c3295b10764ef2f3ac62f97e1e33679edfb..a3ab74ac78444f3de7e0415130cef05d37a2b7c9 100644 GIT binary patch delta 2651 zcma)8eQXrR6`#4C+1b0ByW9KPU7zoK=lj?@pU>R)N5KJqg&1N3j%_#)#x{1aY51^$ zL!21tOiThKEv@9Liqcd?2rATustDSqMNO$xBDJDQm48a9RZ-Onh=v3LRhw`=clHcX zr2f;Lo!NQs&3p5k_h$CZ$F*mhN&o@?D3}2pXxZ2sPpuz0@Gbxj#JEEvdxs|u{bl#x z89mDAiz5doeV_wd0dOjeMq|SVCYF|%CXh}tS{U2&(ylXE?h@-?1;Dmv{Mq4A?*;k} z0QMQi%Z)RJc{l!q(Ki?!9N#-xnxa14M#f;10(H;+k>Q4)s_!wnsL^|erzXHPdy3Ho zM*H>+?|ruBt#pzBa038$PV7H0xrD$N12Ch>0RmiQ7g^+YF;D~;frX8-Vk^YfP_>4v zn3Nx0EcbCO<;&b@)aQTrlkzr=;CGcXdM;gl0hg~ouR90JE5FCLKVQC%!TGD*q{P-( zxh4So09Zj7Ji!1t>z(yhR{d(W24-?830gC`RWRj+Qo24RIjs&pz=WFYf4K{~A1!Xy z>W-pB} zJHgVcx6n7*)>|vX6W@Mka@Cgpp6GL1r<0{kn<8P1irML-=YR9FtKWI?skOySLa_hx zjm6*1tgg%8TW=pZOCxU{Yl+2J^p>tvCWR*cRTe!JVXXUSz>$)!Z1NeOyf+797B~V!(^auJk7mK0JsVM+NaICU{yud#P21{TU*bm+S zr@%Sz3-BKZAO~Av8+-;1!f!%$RA5d{F?UO{quN&c#6j5Cxy+HYNIfoEyaH;VN-sw* ztTJz~%F1e(U+!o`E}v1eYPh6gl}K`4#e6{W!c16|Rpv!Wu8!0uA=PQp%t%+vQsA`NwWVy&+q7D0*K}jw#BaemoTy{0gWUDi2 zv#~`wH0UJd#E)0B0*2YEdbHigcA|!oi5|Iv9VyLIRfC$M216_C%xP>5iZ)kRweuvM z%ct}HaETo%{0OMF>75SAK@yrfH4V1FYP+npYz(VmCUa`DKC+iz&30fuw+6B%&pcQ~ z7-j>)Di`YB*BLq79z%i@waR$xiN+umsTe63+-}}S#ZsiEwbfG_j@0!IchbZA`^{^x zG8OA{y%K#Z;}9c?LKCi3hFSs!Q5i6LWN#>qgCc^2z!Mgna3iJiYlIStKx_YI_cT)> zCQ?C?96q0*HyUw}B3Di28Y*Cmpdgg@QkM&1j^{mA<<9~~N|fgX!Cv=Op`RrJXIz(zy6sctkibma(ClEnM-KLs4fy*X21u0I9 zdJ(J@#M;)rjTR#|a|VT{g;nH8bE3&&sgFfE_H-eivPxecU)xg}IwT6kU#E&CD#az+nP`b3A~5R^_uFhm8rv1~CJB}FmV<10{xQnNv)L)c_>x^#ha$&s$+ zm}sprHZ>WaOy{`6q&0#NGMh>6C!1C%>GiuiE=UH~uvTQDE&8Pw3AW+L`S|(e={vFv2JE!b_1??;kFK6LQ zZgzlg8JL|N`26y~>LwDq4$q zP4Nq+I6HucZ00X6YnqtpFOF|w>fVN`()|1*JCz%ia$!?}yuy@+er3#-PBLMzdI>@|Ew_%}`tswQQL@k)N;jq+x&Zz!3608${UXw R)hb{%HP0%0E_Bed@V_IBEs_8L delta 405 zcmZ3X`$oE+fsuiMfrp`iftkUa`= z2D1#H0AD8SJ0L#<$XCh8E%B}3F=KQE3RnOIq;m3;6GapSJ~A+Hfee(&O{^$jxFl=@ z@}Gqv9q0hC{ALA4U-r$4oEsP?7YeSJ{9GuA z9jFYblV`G>u$&6xM8*@0UzuW=nV6TcD6)jG)UsS+`3;l?DFNc>%KJY diff --git a/contrib/symbolnerdfontmonolist.txt b/contrib/symbolnerdfontmonolist.txt index 1edb964..95e5036 100644 --- a/contrib/symbolnerdfontmonolist.txt +++ b/contrib/symbolnerdfontmonolist.txt @@ -9,3 +9,9 @@ U+f044 U+ed7b U+f142 U+f4eb +U+e70f +U+f31a +U+f302 +U+f30c +U+f489 +U+ef81 \ No newline at end of file From dd2316c946fbe18626fbf140f19137fbecdc8f24 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20T=C3=A1mara?= Date: Tue, 4 Nov 2025 18:23:05 -0500 Subject: [PATCH 2/6] Add link to showcases and enhance contributing ideas --- content/docs/contributing.smd | 23 ++++++++++++++++++----- 1 file changed, 18 insertions(+), 5 deletions(-) diff --git a/content/docs/contributing.smd b/content/docs/contributing.smd index 88cb193..0d91b28 100644 --- a/content/docs/contributing.smd +++ b/content/docs/contributing.smd @@ -38,10 +38,22 @@ way to contribute. When reporting one, it should contain: platform allows to add that information. Issues later on are tagged with proposed version to solve them, in case -it's a low hanging fruit, it's possible that it can be solved pretty +of low hanging fruit, it's possible that it can be solved pretty quick. -Spreading the word is another way to contribute to Flow Code growth. +[]($section.id("showcase")) +## Help others and share your workflows + +We are happy when you [share your workflows](https://discord.gg/XeYatDhh) +or when someone asks something and gets a helpful answer, for example, a +30 sec video is really helpful because it exactly shows how something can +be achieved. Use [asciinema] or whatever allows others to see how to get +things done. + +Spreading the word is another way to contribute to Flow Code growth, +making blog entries and sharing with others what you can build or achieve +with flow; battle testing flow on daily basis helps its improvement and +bring ideas from other places too. []($section.id("developing")) ## Developing @@ -49,10 +61,11 @@ Spreading the word is another way to contribute to Flow Code growth. [Flow Control](https://flow-control.dev/) is programmed with [zig](https://ziglang.org/). -[Fork](https://github.com/neurocyte/flow/fork), no worries, if you -happen to use [codeberg](https://codeberg.org/neurocyte/flow), or +[Fork](https://github.com/neurocyte/flow/fork), no worries in case there +is something with gh, if you happen to use +[codeberg](https://codeberg.org/neurocyte/flow), or [sourcehut](https://git.sr.ht/~neurocyte/flow), it's possible to -fork and contribute via those services too. +contribute via those services too. Using [Discord](https://discord.com/invite/4wvteUPphx) is a good starting point to discuss about what you are about to offer, or if From 7da527a10ec12f1b83d337a16761551d7c620d97 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20T=C3=A1mara?= Date: Tue, 4 Nov 2025 18:24:14 -0500 Subject: [PATCH 3/6] Add Android tips and icons on installation section --- content/docs/platform/android.smd | 33 +++++++++++++++++++++++++++++++ content/installation.smd | 17 ++++++++-------- 2 files changed, 42 insertions(+), 8 deletions(-) create mode 100644 content/docs/platform/android.smd diff --git a/content/docs/platform/android.smd b/content/docs/platform/android.smd new file mode 100644 index 0000000..3bc0202 --- /dev/null +++ b/content/docs/platform/android.smd @@ -0,0 +1,33 @@ +--- +.title = "Android", +.date = @date("2025-11-04T12:24:45+02:00"), +.author = "Igor Támara", +.layout = "index.shtml", +.draft = true, +--- + +flow can be used in Android under [termux](), when in termux, follow +[installation instructions], just copy paste and you are up and running. + + +## Fonts + +Recommended to install monospaced fonts and icons to have the most +comfortable experience. + +[Termux-nf](https://githu.com/arnavgr/termux-nf/) offers various fonts +to choose from, install the fonts installer and the choose your desired +font, for example the same fonts of this website: + +``` +curl -fsSL https://raw.githubusercontent.com/arnavgr/termux-nf/main/install.sh | bash +getnf -i NerdFontsSymbolsOnly +getnf -i Iosevka +``` + +If you run into issues with font installation, install termux-nf +required packages `pkg install curl ncurses-utils` or consult their +[website](https://github.com/arnavgr/termux-nf). + +* [Back to basic usage](/docs/) +* [Share your screenshots](https://discord.gg/XeYatDhh) and [small videos](/docs/contributing#showcase). diff --git a/content/installation.smd b/content/installation.smd index 7679cdd..514e930 100644 --- a/content/installation.smd +++ b/content/installation.smd @@ -6,13 +6,13 @@ .draft = false, --- -- [Linux, MacOS, FreeBSD and Termux](#posix) -- [Windows](#windows) -- [Source](#source) -- [Tarball install](#tarball) +- [ Linux,  MacOS,  FreeBSD and  Termux](#posix) +- [ Windows](#windows) +- [ Source](#source) +- [ Tarball install](#tarball) []($section.id("posix")) -## Linux, MacOS, FreeBSD and Termux +##  Linux,  MacOS,  FreeBSD and  Termux Fetch and install the latest release with the installation helper script: @@ -49,9 +49,10 @@ update-flow At the top of the installer are variables to pre-answer the installation questions. Configure them to your liking. +We have some tips for [Android](/docs/platform/android) []($section.id("windows")) -## Windows +##  Windows For Windows the installer scripts are a little different. @@ -78,14 +79,14 @@ just run `update-flow` in a terminal to update to the latest release or nightly. []($section.id("source")) -## Build from Source +##  Build from Source See the [Building section of `README.md`](https://git.flow-control.dev/neurocyte/flow/src/branch/master/README.md#building) in the source repository for build instructions. []($section.id("tarball")) -## Manual install from tarballs or zip files +##  Manual install from tarballs or zip files See the [downloads](/downloads) page for binaries that you can manually install. Just download, unpack, and place the binary anywhere you want. There are no From e316008995a847d85d20ca11d2c39666e3eadb1c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20T=C3=A1mara?= Date: Tue, 4 Nov 2025 18:30:08 -0500 Subject: [PATCH 4/6] fix: multiline spaces for titles --- assets/css/index.css | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/assets/css/index.css b/assets/css/index.css index 784c29a..4b621fc 100644 --- a/assets/css/index.css +++ b/assets/css/index.css @@ -85,7 +85,7 @@ body { h1, h2, h3, h4, h5, h6 { font-weight: var(--font-weight-bold); margin: calc(var(--line-height) * 2) 0 var(--line-height); - line-height: var(--line-height); + line-height: 1.2em; color: var(--text-color-accent); } From e26903c1012ae3ee99fb3b773892c0297e6b9666 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20T=C3=A1mara?= Date: Tue, 4 Nov 2025 18:47:57 -0500 Subject: [PATCH 5/6] refactor: simplify index.css --- assets/css/index.css | 16 ++-------------- 1 file changed, 2 insertions(+), 14 deletions(-) diff --git a/assets/css/index.css b/assets/css/index.css index 4b621fc..34af40e 100644 --- a/assets/css/index.css +++ b/assets/css/index.css @@ -83,7 +83,8 @@ body { } h1, h2, h3, h4, h5, h6 { - font-weight: var(--font-weight-bold); + font-family: var(--font-family-titles); + font-weight: var(--font-weight-titles); margin: calc(var(--line-height) * 2) 0 var(--line-height); line-height: 1.2em; color: var(--text-color-accent); @@ -93,27 +94,15 @@ h1 { font-size: 6rem; line-height: calc(2 * var(--line-height)); margin-bottom: calc(var(--line-height) * 2); - text-transform: var(--transform); - font-family: var(--font-family-titles); - font-weight: var(--font-weight-titles); } h2 { font-size: 3rem; - font-family: var(--font-family-titles); - font-weight: var(--font-weight-titles); - text-transform: var(--transform); } h3 { font-size: 2rem; - font-family: var(--font-family-titles); - font-weight: var(--font-weight-titles); - text-transform: var(--transform); } h4 { font-size: 1.6rem; - font-family: var(--font-family-titles); - font-weight: var(--font-weight-titles); - text-transform: var(--transform); } hr { position: relative; @@ -380,7 +369,6 @@ button::-moz-focus-inner { } button { - text-transform: var(--transform); font-weight: var(--font-weight-medium); cursor: pointer; } From a6ced2c35237ee67fec02a5e423abedb22f44278 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Igor=20T=C3=A1mara?= Date: Tue, 4 Nov 2025 18:49:10 -0500 Subject: [PATCH 6/6] Fixed some typos and added extern links --- content/docs/contributing.smd | 4 ++-- content/docs/platform/android.smd | 7 ++++--- content/installation.smd | 4 ++-- 3 files changed, 8 insertions(+), 7 deletions(-) diff --git a/content/docs/contributing.smd b/content/docs/contributing.smd index 0d91b28..994a448 100644 --- a/content/docs/contributing.smd +++ b/content/docs/contributing.smd @@ -47,8 +47,8 @@ quick. We are happy when you [share your workflows](https://discord.gg/XeYatDhh) or when someone asks something and gets a helpful answer, for example, a 30 sec video is really helpful because it exactly shows how something can -be achieved. Use [asciinema] or whatever allows others to see how to get -things done. +be achieved. Use [asciinema](https://asciinema.org/) or whatever allows +others to see how you get things done. Spreading the word is another way to contribute to Flow Code growth, making blog entries and sharing with others what you can build or achieve diff --git a/content/docs/platform/android.smd b/content/docs/platform/android.smd index 3bc0202..74f367b 100644 --- a/content/docs/platform/android.smd +++ b/content/docs/platform/android.smd @@ -3,11 +3,12 @@ .date = @date("2025-11-04T12:24:45+02:00"), .author = "Igor Támara", .layout = "index.shtml", -.draft = true, +.draft = false, --- -flow can be used in Android under [termux](), when in termux, follow -[installation instructions], just copy paste and you are up and running. +flow can be used in Android under [termux](https://termux.dev), inside termux, follow +[installation instructions](/installation),i.e., just copy paste and you are up and +running. ## Fonts diff --git a/content/installation.smd b/content/installation.smd index 514e930..013ec9e 100644 --- a/content/installation.smd +++ b/content/installation.smd @@ -32,7 +32,7 @@ with debug symbols: curl -fsSL https://flow-control.dev/install | sh -s -- --nightly --debug ``` -See all avalable options for the installer script: +See all available options for the installer script: ``` curl -fsSL https://flow-control.dev/install | sh -s -- --help @@ -49,7 +49,7 @@ update-flow At the top of the installer are variables to pre-answer the installation questions. Configure them to your liking. -We have some tips for [Android](/docs/platform/android) +We have some tips for [Android](/docs/platform/android/) []($section.id("windows")) ##  Windows