summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authormms <michal@sapka.me>2024-02-21 21:13:07 +0100
committermms <michal@sapka.me>2024-02-21 21:13:07 +0100
commit828acb182ab2ed7a7320ebb138bf55579da1c322 (patch)
treef069d091e985e854de832ab90e847990bcb54366
parent90f8e4a8362c109a8cf046d71d6475deb1b5803e (diff)
feat: new emacs homepage
-rw-r--r--assets/content_images/emacs.pngbin0 -> 98783 bytes
-rw-r--r--content-org/emacs.org83
-rw-r--r--content/emacs/home.md86
-rw-r--r--layouts/_default/baseof.html3
-rw-r--r--layouts/shortcodes/img-c.html3
-rw-r--r--resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_1600x0_resize_q90_h2_box_3.webpbin0 -> 116096 bytes
-rw-r--r--resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_800x0_resize_q90_h2_box_3.webpbin0 -> 50674 bytes
-rw-r--r--static/style.css22
8 files changed, 180 insertions, 17 deletions
diff --git a/assets/content_images/emacs.png b/assets/content_images/emacs.png
new file mode 100644
index 0000000..4f630e3
--- /dev/null
+++ b/assets/content_images/emacs.png
Binary files 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 @@
<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
new file mode 100644
index 0000000..12582df
--- /dev/null
+++ b/resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_1600x0_resize_q90_h2_box_3.webp
Binary files differ
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
new file mode 100644
index 0000000..411dbe2
--- /dev/null
+++ b/resources/_gen/images/emacs_hu2911a1e140c08098424f827f76406561_98783_800x0_resize_q90_h2_box_3.webp
Binary files differ
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);