cmc/cleberg.net

My personal web garden & blog. blog personal website https://cleberg.net

Commit e72ef5b6ca

e72ef5b6cabe7f76f44ae22da8c92a20b8ef4c34

parent: 214c9eb07e

Unsigned

cmc <hello@cleberg.net> · 2025-05-01 03:18 UTC 

update git links

Layout: unified · split

README.md added +86
@@ -0,0 +1,86 @@
1# cleberg.net
2
3[cleberg.net](https://cleberg.net) is my personal webpage and blog. This
4website and blog utilize the powerful Org-Mode publishing system,
5courtesy of the [weblorg](https://github.com/emacs-love/weblorg) Emacs
6package.
7
8## Features & Configuration
9
10This site leverages the flexibility of Org-Mode to allow for easy
11customization through a simple `publish.el` file. For those
12who are interested in tweaking the underlying configuration, the weblorg
13documentation provides all necessary details on possible settings and
14options.
15
16## Getting Started
17
18To begin exploring or contributing to this project, you\'ll first need
19to set up a local copy of the repository. This can be accomplished by
20running the following commands within Emacs:
21
22``` {.bash org-language="sh"}
23git clone https://git.sr.ht/~cyborg/cleberg.net && \
24cd cleberg.net && \
25emacs -nw
26```
27
28Alternatively, if you prefer working with Doom, simply open any of the
29repository files using `Spc f f` and selecting
30`README.org`. From there, feel free to make any necessary
31changes or customizations.
32
33## Building & Publishing the Site
34
35To test the site locally within Emacs, run the following command
36sequence:
37
38Use the `ENV` environment variable to determine which base
39URL weblorg will use. If ENV is omitted, it will default to
40`localhost:8000`. If `ENV=prod`, weblorg will look
41in the `publish.el` file for the production base URL.
42
43``` {.bash org-language="sh"}
44# production:
45ENV=prod emacs --script publish.el
46
47# development:
48emacs --script publish.el
49```
50
51The resulting files can then be deployed to your desired target using
52any method of your choice, such as `scp` or SFTP.
53
54Alternatively, you may prefer to utilize the provided
55`build.sh` script to automate this process. To do so, simply
56customize and run the script as needed.
57
58``` {.bash org-language="sh"}
59# production:
60ENV=prod ./build.sh
61
62# development:
63./build.sh
64```
65
66### Creating New Blog Posts
67
68To quickly create a new blog post within Emacs, follow these steps:
69
701. Run `C-x C-f` (`SPC f f` in Doom) to open a
71 new Org-Mode file.
722. Utilize the `insert-file-contents` command by pressing
73 `C-x i`.
743. Direct the contents of `template.org` (located at
75 `utils/template.org`) into the newly opened file.
76
77This streamlined process allows you to rapidly generate fresh content
78for cleberg.net, taking advantage of the existing template structure and
79formatting.
80
81## Contributing & Tasks
82
83For those interested in contributing to this project or addressing any
84outstanding issues, please refer to the issues tab. This is where you
85can find a comprehensive list of open tickets or submit a new ticket for
86consideration.
README.org deleted −79
@@ -1,79 +0,0 @@
1#+title: README
2
3* cleberg.net
4
5[[https://cleberg.net][cleberg.net]] is my personal webpage and blog. This website and blog utilize the
6powerful Org-Mode publishing system, courtesy of the [[https://github.com/emacs-love/weblorg][weblorg]] Emacs package.
7
8** Features & Configuration
9
10This site leverages the flexibility of Org-Mode to allow for easy customization
11through a simple =publish.el= file. For those who are interested in tweaking the
12underlying configuration, the weblorg documentation provides all necessary
13details on possible settings and options.
14
15** Getting Started
16
17To begin exploring or contributing to this project, you'll first need to set up
18a local copy of the repository. This can be accomplished by running the
19following commands within Emacs:
20
21#+begin_src sh
22git clone https://github.com/ccleberg/cleberg.net && \
23cd cleberg.net && \
24emacs -nw
25#+end_src
26
27#+RESULTS:
28
29Alternatively, if you prefer working with Doom, simply open any of the
30repository files using =Spc f f= and selecting =README.org=. From there, feel
31free to make any necessary changes or customizations.
32
33** Building & Publishing the Site
34
35To test the site locally within Emacs, run the following command sequence:
36
37Use the =ENV= environment variable to determine which base URL weblorg will use.
38If ENV is omitted, it will default to =localhost:8000=. If =ENV=prod=, weblorg
39will look in the =publish.el= file for the production base URL.
40
41#+begin_src sh
42# production:
43ENV=prod emacs --script publish.el
44
45# development:
46emacs --script publish.el
47#+end_src
48
49The resulting files can then be deployed to your desired target using any method
50of your choice, such as =scp= or SFTP.
51
52Alternatively, you may prefer to utilize the provided =build.sh= script to
53automate this process. To do so, simply customize and run the script as needed.
54
55#+begin_src sh
56# production:
57ENV=prod ./build.sh
58
59# development:
60./build.sh
61#+end_src
62
63*** Creating New Blog Posts
64
65To quickly create a new blog post within Emacs, follow these steps:
66
671. Run =C-x C-f= (=SPC f f= in Doom) to open a new Org-Mode file.
682. Utilize the =insert-file-contents= command by pressing =C-x i=.
693. Direct the contents of =template.org= (located at =utils/template.org=) into
70 the newly opened file.
71
72This streamlined process allows you to rapidly generate fresh content for
73cleberg.net, taking advantage of the existing template structure and formatting.
74
75** Contributing & Tasks
76
77For those interested in contributing to this project or addressing any
78outstanding issues, please refer to the issues tab. This is where you can find
79a comprehensive list of open tickets or submit a new ticket for consideration.
content/blog/2022-06-22-daily-poetry.org +1 −1
@@ -7,7 +7,7 @@
77
88I don't want to bury the lede here, so if you'd like to see the full source code
99I use to email myself plaintext poems daily, visit the repository:
10[[https://github.com/ccleberg/daily-poem][daily-poem.git]].
10[[https://git.sr.ht/~cyborg/daily-poem][daily-poem.git]].
1111
1212* My Daily Dose of Poetry
1313
content/blog/2022-12-23-alpine-desktop.org +1 −1
@@ -168,7 +168,7 @@ doas apk add brightnessctl \ # Brightness controller
168168#+end_src
169169
170170From here, I use my Syncthing storage to pull all the configuration files I
171stored from prior desktops, such as my [[https://github.com/ccleberg/dotfiles][dotfiles]].
171stored from prior desktops, such as my [[https://git.sr.ht/~cyborg/dotfiles][dotfiles]].
172172
173173* Resolving Issues
174174
content/blog/2023-02-02-exploring-hare.org +1 −6
@@ -50,14 +50,9 @@ page.
5050
5151** Creating a Test Project
5252
53In order to play with the language, I created [[https://github.com/ccleberg/learn-hare][hare-test]] and will be putting any
53In order to play with the language, I created [[https://git.sr.ht/~cyborg/learn-hare][hare-test]] and will be putting any
5454of my Hare-related adventures in here.
5555
56#+begin_quote
57*Update:* I also created a simple Hare program for creating a file from user
58input: [[https://github.com/ccleberg/learn-hare/blob/main/files/files.ha][files.ha]]
59#+end_quote
60
6156Luckily, Hare doesn't require any complex set-up tools or build
6257environment. Once you have Hare installed, you simply need to create a
6358file ending with =.ha= and you can run a Hare program.
content/blog/2024-08-11-org-mode-features.org +8 −8
@@ -7,7 +7,7 @@
77* Cycling (Folding)
88
99#+begin_quote
10[[https://github.com/ccleberg/cleberg.net/blob/main/content/blog/2024-08-11-org-mode-features.org?plain=1#L7][View this section]] in org-mode.
10[[https://git.sr.ht/~cyborg/cleberg.net/tree/main/item/content/blog/2024-08-11-org-mode-features.org#L7][View this section]] in org-mode.
1111#+end_quote
1212
1313My absolute top-used feature is [[https://orgmode.org/manual/Global-and-local-cycling.html][global and local cycling]] and it's not even
@@ -55,7 +55,7 @@ at the top of the buffer:
5555* TODO Lists
5656
5757#+begin_quote
58[[https://github.com/ccleberg/cleberg.net/blob/main/content/blog/2024-08-11-org-mode-features.org?plain=1#L55][View this section]] in org-mode.
58[[https://git.sr.ht/~cyborg/cleberg.net/tree/main/item/content/blog/2024-08-11-org-mode-features.org#L55][View this section]] in org-mode.
5959#+end_quote
6060
6161Next up on in this post are [[https://orgmode.org/manual/TODO-Items.html][TODO Lists]]. Being able to combine note taking and
@@ -106,7 +106,7 @@ that variable to alert me of tasks with iOS native notifications.
106106* Time Stamping
107107
108108#+begin_quote
109[[https://github.com/ccleberg/cleberg.net/blob/main/content/blog/2024-08-11-org-mode-features.org?plain=1#L106][View this section]] in org-mode.
109[[https://git.sr.ht/~cyborg/cleberg.net/tree/main/item/content/blog/2024-08-11-org-mode-features.org#L106][View this section]] in org-mode.
110110#+end_quote
111111
112112Another great feature are the [[https://orgmode.org/manual/Dates-and-Times.html][dates and times]] functionalities within org-mode.
@@ -137,7 +137,7 @@ different options available when creating timestamps.
137137* Tags
138138
139139#+begin_quote
140[[https://github.com/ccleberg/cleberg.net/blob/main/content/blog/2024-08-11-org-mode-features.org?plain=1#L137][View this section]] in org-mode.
140[[https://git.sr.ht/~cyborg/cleberg.net/tree/main/item/content/blog/2024-08-11-org-mode-features.org#L137][View this section]] in org-mode.
141141#+end_quote
142142
143143Next up are [[https://orgmode.org/manual/Tags.html][Tags]], which provide a way to document contexts within and across
@@ -162,7 +162,7 @@ m= and search for a tag of your choosing.
162162* Tables
163163
164164#+begin_quote
165[[https://github.com/ccleberg/cleberg.net/blob/main/content/blog/2024-08-11-org-mode-features.org?plain=1#L162][View this section]] in org-mode.
165[[https://git.sr.ht/~cyborg/cleberg.net/tree/main/item/content/blog/2024-08-11-org-mode-features.org#L162][View this section]] in org-mode.
166166#+end_quote
167167
168168One of the most inconvenient parts of writing in Markdown was dealing with
@@ -232,7 +232,7 @@ on the second line.
232232* Source Code Blocks
233233
234234#+begin_quote
235[[https://github.com/ccleberg/cleberg.net/blob/main/content/blog/2024-08-11-org-mode-features.org?plain=1#L232][View this section]] in org-mode.
235[[https://git.sr.ht/~cyborg/cleberg.net/tree/main/item/content/blog/2024-08-11-org-mode-features.org#L232][View this section]] in org-mode.
236236#+end_quote
237237
238238** Introduction to Source Code Blocks
@@ -302,7 +302,7 @@ results below the code block.
302302* Exporting and Publishing
303303
304304#+begin_quote
305[[https://github.com/ccleberg/cleberg.net/blob/main/content/blog/2024-08-11-org-mode-features.org?plain=1#L302][View this section]] in org-mode.
305[[https://git.sr.ht/~cyborg/cleberg.net/tree/main/item/content/blog/2024-08-11-org-mode-features.org#L302][View this section]] in org-mode.
306306#+end_quote
307307
308308I would be remiss if I did not mention the native [[https://orgmode.org/manual/Exporting.html][exporting and publishing]]
@@ -336,7 +336,7 @@ external [[https://orgmode.org/tools.html][tools]], including [[https://orgmode.
336336* Agenda
337337
338338#+begin_quote
339[[https://github.com/ccleberg/cleberg.net/blob/main/content/blog/2024-08-11-org-mode-features.org?plain=1#L336][View this section]] in org-mode.
339[[https://git.sr.ht/~cyborg/cleberg.net/tree/main/item/content/blog/2024-08-11-org-mode-features.org#L336][View this section]] in org-mode.
340340#+end_quote
341341
342342Last, but not least, are [[https://orgmode.org/manual/Agenda-Views.html][Agenda Views]]. With agenda views, you can easily view
content/now/index.org +1 −1
@@ -42,4 +42,4 @@ This is a [[https://nownownow.com/about][/now]] page.
4242 share online.
4343- Weather has been warming up, so disc golf frequency is increasing.
4444
45View the historical [[https://github.com/ccleberg/cleberg.net/commits/main/content/now/index.org][log of changes]] for this page.
45View the historical [[https://git.sr.ht/~cyborg/cleberg.net/log/main/item/content/now/index.org][log of changes]] for this page.
content/services/index.org +1 −1
@@ -34,4 +34,4 @@
3434| [[https://send.cleberg.net/][Send]] | Simple, private file sharing |
3535| [[https://slash.cleberg.net/][Slash]] | Bookmark and link sharing platform |
3636
37See the [[https://github.com/ccleberg/cleberg.net/commits/main/content/services/index.org][git log]] if you want to see a log of changes made to this page.
37See the [[https://git.sr.ht/~cyborg/cleberg.net/log/main/item/content/services/index.org][git log]] if you want to see a log of changes made to this page.
theme/templates/base.html +1 −1
@@ -34,7 +34,7 @@
3434 <p>Last build: &lt;<time datetime="{{ now() | strftime("%Y-%m-%d") }}">{{ now() | strftime("%Y-%m-%d %a %H:%M:%S") }}</time>&gt;</p>
3535 <p>
3636 <a href="https://stats.uptimerobot.com/OwOWs7HU0z">Status</a> &middot;
37 <a href="https://github.com/ccleberg/cleberg.net" target="_blank"
37 <a href="https://git.sr.ht/~cyborg/cleberg.net" target="_blank"
3838 rel="noopener">Source Code</a> &middot;
3939 <a href="/feed.xml">RSS Feed</a> &middot;
4040 <a href="/.well-known/security.txt">security.txt</a>
theme/templates/index.html +1 −1
@@ -47,7 +47,7 @@ sub rsa4096 2022-11-16 [E]</pre>
4747 <li>cyb0rg on <a href="https://libera.chat/">libera.chat</a></li>
4848 <li><a href="https://lemmy.cleberg.net/u/cmc">@cmc</a> on Lemmy</li>
4949 <li>@cmc.01 on <a href="https://signal.org/">Signal</a></li>
50 <li><a href="https://github.com/ccleberg">GitHub</a></li>
50 <li><a href="https://git.sr.ht/~cyborg">Sourcehut</a></li>
5151 </ul>
5252</section>
5353