diff options
author | mms <michal@sapka.me> | 2024-02-21 21:13:07 +0100 |
---|---|---|
committer | mms <michal@sapka.me> | 2024-02-21 21:13:07 +0100 |
commit | 828acb182ab2ed7a7320ebb138bf55579da1c322 (patch) | |
tree | f069d091e985e854de832ab90e847990bcb54366 | |
parent | 90f8e4a8362c109a8cf046d71d6475deb1b5803e (diff) |
feat: new emacs homepage
-rw-r--r-- | assets/content_images/emacs.png | bin | 0 -> 98783 bytes | |||
-rw-r--r-- | content-org/emacs.org | 83 | ||||
-rw-r--r-- | content/emacs/home.md | 86 | ||||
-rw-r--r-- | layouts/_default/baseof.html | 3 | ||||
-rw-r--r-- | layouts/shortcodes/img-c.html | 3 | ||||
-rw-r--r-- | resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_1600x0_resize_q90_h2_box_3.webp | bin | 0 -> 116096 bytes | |||
-rw-r--r-- | resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_800x0_resize_q90_h2_box_3.webp | bin | 0 -> 50674 bytes | |||
-rw-r--r-- | static/style.css | 22 |
8 files changed, 180 insertions, 17 deletions
diff --git a/assets/content_images/emacs.png b/assets/content_images/emacs.png Binary files differnew file mode 100644 index 0000000..4f630e3 --- /dev/null +++ b/assets/content_images/emacs.png 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 @@ <meta name="twitter:description" content="{{ .Params.Abstract | default .Site.Params.DefaultDescription}}" > <link rel="canonical" href="{{ .Permalink }}"> - <link rel='alternate' type='application/rss+xml' title="{{ .Site.Title }} RSS" href='/index.xml'> + <link rel='alternate' type='application/rss+xml' title="Feed with all changes" href='/index.xml'> + <link rel='alternate' type='application/rss+xml' title="Feed with Emacs changes" href='/emacs/rss.xml'> <meta name="robots" content="index, follow"> {{ if isset .Params "tags" }}<meta name="keywords" content="{{ with .Params.tags }}{{ delimit . ", " }}{{ end }}">{{end}} <link rel="me" href="https://emacs.ch/@mms"> 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"}} <figure> <img - class="center" + class="center {{ $imgclass }}" alt="{{ $caption }}" src="{{ $img1x.RelPermalink }}" srcset=" diff --git a/resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_1600x0_resize_q90_h2_box_3.webp b/resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_1600x0_resize_q90_h2_box_3.webp Binary files differnew file mode 100644 index 0000000..12582df --- /dev/null +++ b/resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_1600x0_resize_q90_h2_box_3.webp diff --git a/resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_800x0_resize_q90_h2_box_3.webp b/resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_800x0_resize_q90_h2_box_3.webp Binary files differnew file mode 100644 index 0000000..411dbe2 --- /dev/null +++ b/resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_800x0_resize_q90_h2_box_3.webp diff --git a/static/style.css b/static/style.css index d6acbc2..69ed3e5 100644 --- a/static/style.css +++ b/static/style.css @@ -74,6 +74,10 @@ --emacs-highlight-color: #7F5AB6; --emacs-logo-bg-color: var(--emacs-highlight-color); --emacs-h1-color: var(--emacs-highlight-color); + --emacs-h2-color: var(--emacs-highlight-color); + --emacs-h3-color: var(--emacs-highlight-color); + --emacs-h4-color: var(--emacs-highlight-color); + --emacs-h5-color: var(--emacs-highlight-color); } /* blog_variables_end */ @@ -251,7 +255,7 @@ body.blog h1 { } /* blog_header_end */ -/* emacs_header_end */ +/* emacs_header_start */ body.emacs > header > .logo { background-color: var(--emacs-logo-bg-color); } @@ -388,6 +392,15 @@ h2, h3, h4, h5 { h2 { border-bottom-width: 1px; } + +/* emacs_article_start */ +body.emacs h2 { color: var(--emacs-h2-color); border-color: var(--emacs-h2-color) } +body.emacs h3 { color: var(--emacs-h2-color); border-color: var(--emacs-h2-color) } +body.emacs h4 { color: var(--emacs-h2-color); border-color: var(--emacs-h2-color) } +body.emacs h5 { color: var(--emacs-h2-color); border-color: var(--emacs-h2-color) } +body.emacs h6 { color: var(--emacs-h2-color); border-color: var(--emacs-h2-color) } + +/* emacs_article_end */ blockquote { border: 0; @@ -425,9 +438,10 @@ img.float-right { img.center { max-width: 100%; height: auto; - border-style: solid; - border-color: var(--border-color); - border-width: 1px; +} +img.small { + max-width: 50%; + height: auto; } figure.graph { background-color: var(--highlight-bg); |