Commit e72ef5b6ca
Unsigned
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 | ||
| 4 | website and blog utilize the powerful Org-Mode publishing system, | ||
| 5 | courtesy of the [weblorg](https://github.com/emacs-love/weblorg) Emacs | ||
| 6 | package. | ||
| 7 | |||
| 8 | ## Features & Configuration | ||
| 9 | |||
| 10 | This site leverages the flexibility of Org-Mode to allow for easy | ||
| 11 | customization through a simple `publish.el` file. For those | ||
| 12 | who are interested in tweaking the underlying configuration, the weblorg | ||
| 13 | documentation provides all necessary details on possible settings and | ||
| 14 | options. | ||
| 15 | |||
| 16 | ## Getting Started | ||
| 17 | |||
| 18 | To begin exploring or contributing to this project, you\'ll first need | ||
| 19 | to set up a local copy of the repository. This can be accomplished by | ||
| 20 | running the following commands within Emacs: | ||
| 21 | |||
| 22 | ``` {.bash org-language="sh"} | ||
| 23 | git clone https://git.sr.ht/~cyborg/cleberg.net && \ | ||
| 24 | cd cleberg.net && \ | ||
| 25 | emacs -nw | ||
| 26 | ``` | ||
| 27 | |||
| 28 | Alternatively, if you prefer working with Doom, simply open any of the | ||
| 29 | repository files using `Spc f f` and selecting | ||
| 30 | `README.org`. From there, feel free to make any necessary | ||
| 31 | changes or customizations. | ||
| 32 | |||
| 33 | ## Building & Publishing the Site | ||
| 34 | |||
| 35 | To test the site locally within Emacs, run the following command | ||
| 36 | sequence: | ||
| 37 | |||
| 38 | Use the `ENV` environment variable to determine which base | ||
| 39 | URL weblorg will use. If ENV is omitted, it will default to | ||
| 40 | `localhost:8000`. If `ENV=prod`, weblorg will look | ||
| 41 | in the `publish.el` file for the production base URL. | ||
| 42 | |||
| 43 | ``` {.bash org-language="sh"} | ||
| 44 | # production: | ||
| 45 | ENV=prod emacs --script publish.el | ||
| 46 | |||
| 47 | # development: | ||
| 48 | emacs --script publish.el | ||
| 49 | ``` | ||
| 50 | |||
| 51 | The resulting files can then be deployed to your desired target using | ||
| 52 | any method of your choice, such as `scp` or SFTP. | ||
| 53 | |||
| 54 | Alternatively, you may prefer to utilize the provided | ||
| 55 | `build.sh` script to automate this process. To do so, simply | ||
| 56 | customize and run the script as needed. | ||
| 57 | |||
| 58 | ``` {.bash org-language="sh"} | ||
| 59 | # production: | ||
| 60 | ENV=prod ./build.sh | ||
| 61 | |||
| 62 | # development: | ||
| 63 | ./build.sh | ||
| 64 | ``` | ||
| 65 | |||
| 66 | ### Creating New Blog Posts | ||
| 67 | |||
| 68 | To quickly create a new blog post within Emacs, follow these steps: | ||
| 69 | |||
| 70 | 1. Run `C-x C-f` (`SPC f f` in Doom) to open a | ||
| 71 | new Org-Mode file. | ||
| 72 | 2. Utilize the `insert-file-contents` command by pressing | ||
| 73 | `C-x i`. | ||
| 74 | 3. Direct the contents of `template.org` (located at | ||
| 75 | `utils/template.org`) into the newly opened file. | ||
| 76 | |||
| 77 | This streamlined process allows you to rapidly generate fresh content | ||
| 78 | for cleberg.net, taking advantage of the existing template structure and | ||
| 79 | formatting. | ||
| 80 | |||
| 81 | ## Contributing & Tasks | ||
| 82 | |||
| 83 | For those interested in contributing to this project or addressing any | ||
| 84 | outstanding issues, please refer to the issues tab. This is where you | ||
| 85 | can find a comprehensive list of open tickets or submit a new ticket for | ||
| 86 | consideration. | ||
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 | ||
| 6 | powerful Org-Mode publishing system, courtesy of the [[https://github.com/emacs-love/weblorg][weblorg]] Emacs package. | ||
| 7 | |||
| 8 | ** Features & Configuration | ||
| 9 | |||
| 10 | This site leverages the flexibility of Org-Mode to allow for easy customization | ||
| 11 | through a simple =publish.el= file. For those who are interested in tweaking the | ||
| 12 | underlying configuration, the weblorg documentation provides all necessary | ||
| 13 | details on possible settings and options. | ||
| 14 | |||
| 15 | ** Getting Started | ||
| 16 | |||
| 17 | To begin exploring or contributing to this project, you'll first need to set up | ||
| 18 | a local copy of the repository. This can be accomplished by running the | ||
| 19 | following commands within Emacs: | ||
| 20 | |||
| 21 | #+begin_src sh | ||
| 22 | git clone https://github.com/ccleberg/cleberg.net && \ | ||
| 23 | cd cleberg.net && \ | ||
| 24 | emacs -nw | ||
| 25 | #+end_src | ||
| 26 | |||
| 27 | #+RESULTS: | ||
| 28 | |||
| 29 | Alternatively, if you prefer working with Doom, simply open any of the | ||
| 30 | repository files using =Spc f f= and selecting =README.org=. From there, feel | ||
| 31 | free to make any necessary changes or customizations. | ||
| 32 | |||
| 33 | ** Building & Publishing the Site | ||
| 34 | |||
| 35 | To test the site locally within Emacs, run the following command sequence: | ||
| 36 | |||
| 37 | Use the =ENV= environment variable to determine which base URL weblorg will use. | ||
| 38 | If ENV is omitted, it will default to =localhost:8000=. If =ENV=prod=, weblorg | ||
| 39 | will look in the =publish.el= file for the production base URL. | ||
| 40 | |||
| 41 | #+begin_src sh | ||
| 42 | # production: | ||
| 43 | ENV=prod emacs --script publish.el | ||
| 44 | |||
| 45 | # development: | ||
| 46 | emacs --script publish.el | ||
| 47 | #+end_src | ||
| 48 | |||
| 49 | The resulting files can then be deployed to your desired target using any method | ||
| 50 | of your choice, such as =scp= or SFTP. | ||
| 51 | |||
| 52 | Alternatively, you may prefer to utilize the provided =build.sh= script to | ||
| 53 | automate this process. To do so, simply customize and run the script as needed. | ||
| 54 | |||
| 55 | #+begin_src sh | ||
| 56 | # production: | ||
| 57 | ENV=prod ./build.sh | ||
| 58 | |||
| 59 | # development: | ||
| 60 | ./build.sh | ||
| 61 | #+end_src | ||
| 62 | |||
| 63 | *** Creating New Blog Posts | ||
| 64 | |||
| 65 | To quickly create a new blog post within Emacs, follow these steps: | ||
| 66 | |||
| 67 | 1. Run =C-x C-f= (=SPC f f= in Doom) to open a new Org-Mode file. | ||
| 68 | 2. Utilize the =insert-file-contents= command by pressing =C-x i=. | ||
| 69 | 3. Direct the contents of =template.org= (located at =utils/template.org=) into | ||
| 70 | the newly opened file. | ||
| 71 | |||
| 72 | This streamlined process allows you to rapidly generate fresh content for | ||
| 73 | cleberg.net, taking advantage of the existing template structure and formatting. | ||
| 74 | |||
| 75 | ** Contributing & Tasks | ||
| 76 | |||
| 77 | For those interested in contributing to this project or addressing any | ||
| 78 | outstanding issues, please refer to the issues tab. This is where you can find | ||
| 79 | a 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 @@ | |||
| 7 | 7 | ||
| 8 | I don't want to bury the lede here, so if you'd like to see the full source code | 8 | I don't want to bury the lede here, so if you'd like to see the full source code |
| 9 | I use to email myself plaintext poems daily, visit the repository: | 9 | I 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]]. |
| 11 | 11 | ||
| 12 | * My Daily Dose of Poetry | 12 | * My Daily Dose of Poetry |
| 13 | 13 | ||
content/blog/2022-12-23-alpine-desktop.org +1 −1
| @@ -168,7 +168,7 @@ doas apk add brightnessctl \ # Brightness controller | |||
| 168 | #+end_src | 168 | #+end_src |
| 169 | 169 | ||
| 170 | From here, I use my Syncthing storage to pull all the configuration files I | 170 | From here, I use my Syncthing storage to pull all the configuration files I |
| 171 | stored from prior desktops, such as my [[https://github.com/ccleberg/dotfiles][dotfiles]]. | 171 | stored from prior desktops, such as my [[https://git.sr.ht/~cyborg/dotfiles][dotfiles]]. |
| 172 | 172 | ||
| 173 | * Resolving Issues | 173 | * Resolving Issues |
| 174 | 174 | ||
content/blog/2023-02-02-exploring-hare.org +1 −6
| @@ -50,14 +50,9 @@ page. | |||
| 50 | 50 | ||
| 51 | ** Creating a Test Project | 51 | ** Creating a Test Project |
| 52 | 52 | ||
| 53 | In order to play with the language, I created [[https://github.com/ccleberg/learn-hare][hare-test]] and will be putting any | 53 | In order to play with the language, I created [[https://git.sr.ht/~cyborg/learn-hare][hare-test]] and will be putting any |
| 54 | of my Hare-related adventures in here. | 54 | of my Hare-related adventures in here. |
| 55 | 55 | ||
| 56 | #+begin_quote | ||
| 57 | *Update:* I also created a simple Hare program for creating a file from user | ||
| 58 | input: [[https://github.com/ccleberg/learn-hare/blob/main/files/files.ha][files.ha]] | ||
| 59 | #+end_quote | ||
| 60 | |||
| 61 | Luckily, Hare doesn't require any complex set-up tools or build | 56 | Luckily, Hare doesn't require any complex set-up tools or build |
| 62 | environment. Once you have Hare installed, you simply need to create a | 57 | environment. Once you have Hare installed, you simply need to create a |
| 63 | file ending with =.ha= and you can run a Hare program. | 58 | file 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 @@ | |||
| 7 | * Cycling (Folding) | 7 | * Cycling (Folding) |
| 8 | 8 | ||
| 9 | #+begin_quote | 9 | #+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. |
| 11 | #+end_quote | 11 | #+end_quote |
| 12 | 12 | ||
| 13 | My absolute top-used feature is [[https://orgmode.org/manual/Global-and-local-cycling.html][global and local cycling]] and it's not even | 13 | My 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: | |||
| 55 | * TODO Lists | 55 | * TODO Lists |
| 56 | 56 | ||
| 57 | #+begin_quote | 57 | #+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. |
| 59 | #+end_quote | 59 | #+end_quote |
| 60 | 60 | ||
| 61 | Next up on in this post are [[https://orgmode.org/manual/TODO-Items.html][TODO Lists]]. Being able to combine note taking and | 61 | Next 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. | |||
| 106 | * Time Stamping | 106 | * Time Stamping |
| 107 | 107 | ||
| 108 | #+begin_quote | 108 | #+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. |
| 110 | #+end_quote | 110 | #+end_quote |
| 111 | 111 | ||
| 112 | Another great feature are the [[https://orgmode.org/manual/Dates-and-Times.html][dates and times]] functionalities within org-mode. | 112 | Another 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. | |||
| 137 | * Tags | 137 | * Tags |
| 138 | 138 | ||
| 139 | #+begin_quote | 139 | #+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. |
| 141 | #+end_quote | 141 | #+end_quote |
| 142 | 142 | ||
| 143 | Next up are [[https://orgmode.org/manual/Tags.html][Tags]], which provide a way to document contexts within and across | 143 | Next 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. | |||
| 162 | * Tables | 162 | * Tables |
| 163 | 163 | ||
| 164 | #+begin_quote | 164 | #+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. |
| 166 | #+end_quote | 166 | #+end_quote |
| 167 | 167 | ||
| 168 | One of the most inconvenient parts of writing in Markdown was dealing with | 168 | One of the most inconvenient parts of writing in Markdown was dealing with |
| @@ -232,7 +232,7 @@ on the second line. | |||
| 232 | * Source Code Blocks | 232 | * Source Code Blocks |
| 233 | 233 | ||
| 234 | #+begin_quote | 234 | #+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. |
| 236 | #+end_quote | 236 | #+end_quote |
| 237 | 237 | ||
| 238 | ** Introduction to Source Code Blocks | 238 | ** Introduction to Source Code Blocks |
| @@ -302,7 +302,7 @@ results below the code block. | |||
| 302 | * Exporting and Publishing | 302 | * Exporting and Publishing |
| 303 | 303 | ||
| 304 | #+begin_quote | 304 | #+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. |
| 306 | #+end_quote | 306 | #+end_quote |
| 307 | 307 | ||
| 308 | I would be remiss if I did not mention the native [[https://orgmode.org/manual/Exporting.html][exporting and publishing]] | 308 | I 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. | |||
| 336 | * Agenda | 336 | * Agenda |
| 337 | 337 | ||
| 338 | #+begin_quote | 338 | #+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. |
| 340 | #+end_quote | 340 | #+end_quote |
| 341 | 341 | ||
| 342 | Last, but not least, are [[https://orgmode.org/manual/Agenda-Views.html][Agenda Views]]. With agenda views, you can easily view | 342 | Last, 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. | |||
| 42 | share online. | 42 | share online. |
| 43 | - Weather has been warming up, so disc golf frequency is increasing. | 43 | - Weather has been warming up, so disc golf frequency is increasing. |
| 44 | 44 | ||
| 45 | View the historical [[https://github.com/ccleberg/cleberg.net/commits/main/content/now/index.org][log of changes]] for this page. | 45 | View 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 @@ | |||
| 34 | | [[https://send.cleberg.net/][Send]] | Simple, private file sharing | | 34 | | [[https://send.cleberg.net/][Send]] | Simple, private file sharing | |
| 35 | | [[https://slash.cleberg.net/][Slash]] | Bookmark and link sharing platform | | 35 | | [[https://slash.cleberg.net/][Slash]] | Bookmark and link sharing platform | |
| 36 | 36 | ||
| 37 | See 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. | 37 | See 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 @@ | |||
| 34 | <p>Last build: <<time datetime="{{ now() | strftime("%Y-%m-%d") }}">{{ now() | strftime("%Y-%m-%d %a %H:%M:%S") }}</time>></p> | 34 | <p>Last build: <<time datetime="{{ now() | strftime("%Y-%m-%d") }}">{{ now() | strftime("%Y-%m-%d %a %H:%M:%S") }}</time>></p> |
| 35 | <p> | 35 | <p> |
| 36 | <a href="https://stats.uptimerobot.com/OwOWs7HU0z">Status</a> · | 36 | <a href="https://stats.uptimerobot.com/OwOWs7HU0z">Status</a> · |
| 37 | <a href="https://github.com/ccleberg/cleberg.net" target="_blank" | 37 | <a href="https://git.sr.ht/~cyborg/cleberg.net" target="_blank" |
| 38 | rel="noopener">Source Code</a> · | 38 | rel="noopener">Source Code</a> · |
| 39 | <a href="/feed.xml">RSS Feed</a> · | 39 | <a href="/feed.xml">RSS Feed</a> · |
| 40 | <a href="/.well-known/security.txt">security.txt</a> | 40 | <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> | |||
| 47 | <li>cyb0rg on <a href="https://libera.chat/">libera.chat</a></li> | 47 | <li>cyb0rg on <a href="https://libera.chat/">libera.chat</a></li> |
| 48 | <li><a href="https://lemmy.cleberg.net/u/cmc">@cmc</a> on Lemmy</li> | 48 | <li><a href="https://lemmy.cleberg.net/u/cmc">@cmc</a> on Lemmy</li> |
| 49 | <li>@cmc.01 on <a href="https://signal.org/">Signal</a></li> | 49 | <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> |
| 51 | </ul> | 51 | </ul> |
| 52 | </section> | 52 | </section> |
| 53 | 53 | ||