From 828acb182ab2ed7a7320ebb138bf55579da1c322 Mon Sep 17 00:00:00 2001 From: mms Date: Wed, 21 Feb 2024 21:13:07 +0100 Subject: feat: new emacs homepage --- assets/content_images/emacs.png | Bin 0 -> 98783 bytes content-org/emacs.org | 83 ++++++++++++++++++-- content/emacs/home.md | 86 +++++++++++++++++++-- layouts/_default/baseof.html | 3 +- layouts/shortcodes/img-c.html | 3 +- ...f76406561_98783_1600x0_resize_q90_h2_box_3.webp | Bin 0 -> 116096 bytes ...7f76406561_98783_800x0_resize_q90_h2_box_3.webp | Bin 0 -> 50674 bytes static/style.css | 22 +++++- 8 files changed, 180 insertions(+), 17 deletions(-) create mode 100644 assets/content_images/emacs.png create mode 100644 resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_1600x0_resize_q90_h2_box_3.webp create mode 100644 resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_800x0_resize_q90_h2_box_3.webp diff --git a/assets/content_images/emacs.png b/assets/content_images/emacs.png new file mode 100644 index 0000000..4f630e3 Binary files /dev/null and b/assets/content_images/emacs.png differ diff --git a/content-org/emacs.org b/content-org/emacs.org index 76817ee..0985b02 100644 --- a/content-org/emacs.org +++ b/content-org/emacs.org @@ -13,27 +13,98 @@ CLOSED: [2023-12-24 Wed 20:00] :PROPERTIES: :EXPORT_FILE_NAME: home :EXPORT_HUGO_CUSTOM_FRONT_MATTER: :abstract My little website about Emacs :hardback true :type special -:EXPORT_HUGO_PAIRED_SHORTCODES: recent-updates st-logo menu +:EXPORT_HUGO_PAIRED_SHORTCODES: recent-updates st-logo menu img-c :END: -I am new to Emacs (a little over a year, with a break), so I am in outsider's position. -Most users of Emacs I've met have been using this editor for decades, and since it's not that popular, there are not many noobs out there. -This website is a recording of my findings, as Emacs is a completely different beast compared to any other editor I've ever used. +** What is Emacs? -*** Guides +Emacs is one of the oldest text editors out there. +Together with Vim, they are the best ways to manipulate text. + +However, Emacs is so much more. +Under the hood it rocks the amazing Emacs Lisp language, which can be easily used to adjust virtually any aspect of Emacs to your liking. +This also allowed Emacs to evolve into the /de facto/ shell we use. +You can use it as file manager (/dired/), as music player (/emms/), internet browser (/eww/), email client (/mu4e/), RSS reader (/elfeed/), terminal client (/eshell/), and so much more. +It also is the place where /org-mode/ lives, the single best way to organize your life. + +#+attr_shortcode: "emacs.png" "https://www.gnu.org/software/emacs/" "small" +#+begin_img-c +Emacs +#+end_img-c + +** GNU Emacs + +Emacs is am /old/ program, which was rewritten multiple times. +Currently, the most popular version is /GNU Emacs/ available under /GPL License/. + +It is /free/ program - which means that only you don't need to pay for it, but you are free to modify and redistiribute it. +In fact, you are encouraged to. + +Current emacs version: *[[https://www.gnu.org/software/emacs/news/NEWS.29.2][29.2]]* (2024-01-18). New version is released every few months. + +** Getting Emacs + +Emacs is available on most platforms - Linux, BSD, Mac, even Windows. +Simply download the version for your OS form [[https://www.gnu.org/software/emacs/][The official website]] or, even better, compile it from source. + +It is also available in all good package managers (pkg, apt, brew, and so son) + +** Evil Mode + +There is a joke, that Emacs is a great operating system, but it lacks a decent text editor. +If you are afraid of using keyboard shortcuts like "ctrl-x ctrl-s" just to save file, you can install the best Vim mode out there - Evil Mode. +It supports all the keys and most of the ex-commands. + +** My Guides [[[/emacs/rss.xml][rss]]] + +I wrote a few guides you may find interesting #+attr_shortcode: "emacs-guides" #+begin_menu Guides #+end_menu -*** Varia +** My Varia [[[/emacs/rss.xml][rss]]] + +Emacs is also a way of life. +You can my general emacs-related rambling here: #+attr_shortcode: "emacs-varia" #+begin_menu Varia #+end_menu +** Emacs on the Web + +- [[https://www.gnu.org/software/emacs/][Official website]] +- [[https://www.gnu.org/software/emacs/manual/][GNU Emacs Manuals]] - GNU provides all the documentation one might need +- [[https://planet.emacslife.com/][Planet Emacslife]] - news about Emacs from all around the web, +- [[https://reddit.com/r/emacs][Reddit group]] - if you still use Reddit, you will find vibrant community here +- [[https://emacs.ch][Emacs.ch]] - Mastodon server for Emacs crowd +- [[https://protesilaos.com/][Protesilaos Stavrou website]] - a very prolific Emacs educator +- [[https://www.youtube.com/@emacselements][Emacs Elements [YouTube]​]] - a YouTube channel with great Emacs tutorials +- [[https://xahlee.info/emacs][Xah Emacs Tutorial]] - a great reference and companion + +** EmacsConf + +Every year there is a conference for Emacs users: + +- [[https://emacsconf.org/2023/][EmacsConf 2023]] +- [[https://emacsconf.org/2022/][EmacsConf 2022]] +- [[https://emacsconf.org/2021/][EmacsConf 2021]] +- [[https://emacsconf.org/2020/][EmacsConf 2020]] +- [[https://emacsconf.org/2019/][EmacsConf 2019]] +- [[https://emacsconf.org/2015][EmacsConf 2015]] +- [[https://emacsconf.org/2013/][EmacsConf 2013]] + +Date of the next EmacsConf: *TBD.* + +** Other distributions + +*While /Gnu Emacs/ is wonderful, it requires significant time and effort to make it friendly. +A lot of people are not fans of the default configurations. +If you are one of them, you may instead try some ready Emacs distributions, like /[[https://github.com/doomemacs/doomemacs][Doom Emacs]]/ or /[[https://www.spacemacs.org/][Spacemacs]]/. + * Guides :@emacs: :PROPERTIES: :EXPORT_HUGO_MENU: :menu emacs-guides diff --git a/content/emacs/home.md b/content/emacs/home.md index cdb51e4..26a03d7 100644 --- a/content/emacs/home.md +++ b/content/emacs/home.md @@ -10,20 +10,96 @@ hardback = true type = "special" +++ -I am new to Emacs (a little over a year, with a break), so I am in outsider's position. -Most users of Emacs I've met have been using this editor for decades, and since it's not that popular, there are not many noobs out there. -This website is a recording of my findings, as Emacs is a completely different beast compared to any other editor I've ever used. +## What is Emacs? {#what-is-emacs} +Emacs is one of the oldest text editors out there. +Together with Vim, they are the best ways to manipulate text. -## Guides {#guides} +However, Emacs is so much more. +Under the hood it rocks the amazing Emacs Lisp language, which can be easily used to adjust virtually any aspect of Emacs to your liking. +This also allowed Emacs to evolve into the _de facto_ shell we use. +You can use it as file manager (_dired_), as music player (_emms_), internet browser (_eww_), email client (_mu4e_), RSS reader (_elfeed_), terminal client (_eshell_), and so much more. +It also is the place where _org-mode_ lives, the single best way to organize your life. + +{{< img-c "emacs.png" "https://www.gnu.org/software/emacs/" "small" >}} +Emacs +{{< /img-c >}} + + +## GNU Emacs {#gnu-emacs} + +Emacs is am _old_ program, which was rewritten multiple times. +Currently, the most popular version is _GNU Emacs_ available under _GPL License_. + +It is _free_ program - which means that only you don't need to pay for it, but you are free to modify and redistiribute it. +In fact, you are encouraged to. + +Current emacs version: **[29.2](https://www.gnu.org/software/emacs/news/NEWS.29.2)** (2024-01-18). New version is released every few months. + + +## Getting Emacs {#getting-emacs} + +Emacs is available on most platforms - Linux, BSD, Mac, even Windows. +Simply download the version for your OS form [The official website](https://www.gnu.org/software/emacs/) or, even better, compile it from source. + +It is also available in all good package managers (pkg, apt, brew, and so son) + + +## Evil Mode {#evil-mode} + +There is a joke, that Emacs is a great operating system, but it lacks a decent text editor. +If you are afraid of using keyboard shortcuts like "ctrl-x ctrl-s" just to save file, you can install the best Vim mode out there - Evil Mode. +It supports all the keys and most of the ex-commands. + + +## My Guides [[rss](/emacs/rss.xml)] {#my-guides-rss} + +I wrote a few guides you may find interesting {{< menu "emacs-guides" >}} Guides {{< /menu >}} -## Varia {#varia} +## My Varia [[rss](/emacs/rss.xml)] {#my-varia-rss} + +Emacs is also a way of life. +You can my general emacs-related rambling here: {{< menu "emacs-varia" >}} Varia {{< /menu >}} + + +## Emacs on the Web {#emacs-on-the-web} + +- [Official website](https://www.gnu.org/software/emacs/) +- [GNU Emacs Manuals](https://www.gnu.org/software/emacs/manual/) - GNU provides all the documentation one might need +- [Planet Emacslife](https://planet.emacslife.com/) - news about Emacs from all around the web, +- [Reddit group](https://reddit.com/r/emacs) - if you still use Reddit, you will find vibrant community here +- [Emacs.ch](https://emacs.ch) - Mastodon server for Emacs crowd +- [Protesilaos Stavrou website](https://protesilaos.com/) - a very prolific Emacs educator +- [Emacs Elements [YouTube]​](https://www.youtube.com/@emacselements) - a YouTube channel with great Emacs tutorials +- [Xah Emacs Tutorial](https://xahlee.info/emacs) - a great reference and companion + + +## EmacsConf {#emacsconf} + +Every year there is a conference for Emacs users: + +- [EmacsConf 2023](https://emacsconf.org/2023/) +- [EmacsConf 2022](https://emacsconf.org/2022/) +- [EmacsConf 2021](https://emacsconf.org/2021/) +- [EmacsConf 2020](https://emacsconf.org/2020/) +- [EmacsConf 2019](https://emacsconf.org/2019/) +- [EmacsConf 2015](https://emacsconf.org/2015) +- [EmacsConf 2013](https://emacsconf.org/2013/) + +Date of the next EmacsConf: **TBD.** + + +## Other distributions {#other-distributions} + +\*While _Gnu Emacs_ is wonderful, it requires significant time and effort to make it friendly. +A lot of people are not fans of the default configurations. +If you are one of them, you may instead try some ready Emacs distributions, like _[Doom Emacs](https://github.com/doomemacs/doomemacs)_ or _[Spacemacs](https://www.spacemacs.org/)_. diff --git a/layouts/_default/baseof.html b/layouts/_default/baseof.html index 83ef4a6..f92b8b9 100644 --- a/layouts/_default/baseof.html +++ b/layouts/_default/baseof.html @@ -31,7 +31,8 @@ - + + {{ if isset .Params "tags" }}{{end}} diff --git a/layouts/shortcodes/img-c.html b/layouts/shortcodes/img-c.html index 641f5bd..3da2c5c 100644 --- a/layouts/shortcodes/img-c.html +++ b/layouts/shortcodes/img-c.html @@ -3,11 +3,12 @@ {{- $img := resources.Get $path }} {{- $caption := .Inner }} {{- $source := .Get 1 }} +{{- $imgclass := .Get 2 }} {{- $img1x := $img.Resize "800x webp q90"}} {{- $img2x := $img.Resize "1600x webp q90"}}