diff options
| -rw-r--r-- | README.md | 86 | ||||
| -rw-r--r-- | README.org | 79 | ||||
| -rw-r--r-- | content/blog/2022-06-22-daily-poetry.org | 2 | ||||
| -rw-r--r-- | content/blog/2022-12-23-alpine-desktop.org | 2 | ||||
| -rw-r--r-- | content/blog/2023-02-02-exploring-hare.org | 7 | ||||
| -rw-r--r-- | content/blog/2024-08-11-org-mode-features.org | 16 | ||||
| -rw-r--r-- | content/now/index.org | 2 | ||||
| -rw-r--r-- | content/services/index.org | 2 | ||||
| -rw-r--r-- | theme/templates/base.html | 2 | ||||
| -rw-r--r-- | theme/templates/index.html | 2 |
10 files changed, 101 insertions, 99 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..49fe00c --- /dev/null +++ b/README.md @@ -0,0 +1,86 @@ +# cleberg.net + +[cleberg.net](https://cleberg.net) is my personal webpage and blog. This +website and blog utilize the powerful Org-Mode publishing system, +courtesy of the [weblorg](https://github.com/emacs-love/weblorg) Emacs +package. + +## Features & Configuration + +This site leverages the flexibility of Org-Mode to allow for easy +customization through a simple `publish.el` file. For those +who are interested in tweaking the underlying configuration, the weblorg +documentation provides all necessary details on possible settings and +options. + +## Getting Started + +To begin exploring or contributing to this project, you\'ll first need +to set up a local copy of the repository. This can be accomplished by +running the following commands within Emacs: + +``` {.bash org-language="sh"} +git clone https://git.sr.ht/~cyborg/cleberg.net && \ +cd cleberg.net && \ +emacs -nw +``` + +Alternatively, if you prefer working with Doom, simply open any of the +repository files using `Spc f f` and selecting +`README.org`. From there, feel free to make any necessary +changes or customizations. + +## Building & Publishing the Site + +To test the site locally within Emacs, run the following command +sequence: + +Use the `ENV` environment variable to determine which base +URL weblorg will use. If ENV is omitted, it will default to +`localhost:8000`. If `ENV=prod`, weblorg will look +in the `publish.el` file for the production base URL. + +``` {.bash org-language="sh"} +# production: +ENV=prod emacs --script publish.el + +# development: +emacs --script publish.el +``` + +The resulting files can then be deployed to your desired target using +any method of your choice, such as `scp` or SFTP. + +Alternatively, you may prefer to utilize the provided +`build.sh` script to automate this process. To do so, simply +customize and run the script as needed. + +``` {.bash org-language="sh"} +# production: +ENV=prod ./build.sh + +# development: +./build.sh +``` + +### Creating New Blog Posts + +To quickly create a new blog post within Emacs, follow these steps: + +1. Run `C-x C-f` (`SPC f f` in Doom) to open a + new Org-Mode file. +2. Utilize the `insert-file-contents` command by pressing + `C-x i`. +3. Direct the contents of `template.org` (located at + `utils/template.org`) into the newly opened file. + +This streamlined process allows you to rapidly generate fresh content +for cleberg.net, taking advantage of the existing template structure and +formatting. + +## Contributing & Tasks + +For those interested in contributing to this project or addressing any +outstanding issues, please refer to the issues tab. This is where you +can find a comprehensive list of open tickets or submit a new ticket for +consideration. diff --git a/README.org b/README.org deleted file mode 100644 index c3fc36f..0000000 --- a/README.org +++ /dev/null @@ -1,79 +0,0 @@ -#+title: README - -* cleberg.net - -[[https://cleberg.net][cleberg.net]] is my personal webpage and blog. This website and blog utilize the -powerful Org-Mode publishing system, courtesy of the [[https://github.com/emacs-love/weblorg][weblorg]] Emacs package. - -** Features & Configuration - -This site leverages the flexibility of Org-Mode to allow for easy customization -through a simple =publish.el= file. For those who are interested in tweaking the -underlying configuration, the weblorg documentation provides all necessary -details on possible settings and options. - -** Getting Started - -To begin exploring or contributing to this project, you'll first need to set up -a local copy of the repository. This can be accomplished by running the -following commands within Emacs: - -#+begin_src sh -git clone https://github.com/ccleberg/cleberg.net && \ -cd cleberg.net && \ -emacs -nw -#+end_src - -#+RESULTS: - -Alternatively, if you prefer working with Doom, simply open any of the -repository files using =Spc f f= and selecting =README.org=. From there, feel -free to make any necessary changes or customizations. - -** Building & Publishing the Site - -To test the site locally within Emacs, run the following command sequence: - -Use the =ENV= environment variable to determine which base URL weblorg will use. -If ENV is omitted, it will default to =localhost:8000=. If =ENV=prod=, weblorg -will look in the =publish.el= file for the production base URL. - -#+begin_src sh -# production: -ENV=prod emacs --script publish.el - -# development: -emacs --script publish.el -#+end_src - -The resulting files can then be deployed to your desired target using any method -of your choice, such as =scp= or SFTP. - -Alternatively, you may prefer to utilize the provided =build.sh= script to -automate this process. To do so, simply customize and run the script as needed. - -#+begin_src sh -# production: -ENV=prod ./build.sh - -# development: -./build.sh -#+end_src - -*** Creating New Blog Posts - -To quickly create a new blog post within Emacs, follow these steps: - -1. Run =C-x C-f= (=SPC f f= in Doom) to open a new Org-Mode file. -2. Utilize the =insert-file-contents= command by pressing =C-x i=. -3. Direct the contents of =template.org= (located at =utils/template.org=) into - the newly opened file. - -This streamlined process allows you to rapidly generate fresh content for -cleberg.net, taking advantage of the existing template structure and formatting. - -** Contributing & Tasks - -For those interested in contributing to this project or addressing any -outstanding issues, please refer to the issues tab. This is where you can find -a comprehensive list of open tickets or submit a new ticket for consideration. diff --git a/content/blog/2022-06-22-daily-poetry.org b/content/blog/2022-06-22-daily-poetry.org index 7e40934..4a472b5 100644 --- a/content/blog/2022-06-22-daily-poetry.org +++ b/content/blog/2022-06-22-daily-poetry.org @@ -7,7 +7,7 @@ I don't want to bury the lede here, so if you'd like to see the full source code I use to email myself plaintext poems daily, visit the repository: -[[https://github.com/ccleberg/daily-poem][daily-poem.git]]. +[[https://git.sr.ht/~cyborg/daily-poem][daily-poem.git]]. * My Daily Dose of Poetry diff --git a/content/blog/2022-12-23-alpine-desktop.org b/content/blog/2022-12-23-alpine-desktop.org index 7d32df7..7f98d2d 100644 --- a/content/blog/2022-12-23-alpine-desktop.org +++ b/content/blog/2022-12-23-alpine-desktop.org @@ -168,7 +168,7 @@ doas apk add brightnessctl \ # Brightness controller #+end_src From here, I use my Syncthing storage to pull all the configuration files I -stored from prior desktops, such as my [[https://github.com/ccleberg/dotfiles][dotfiles]]. +stored from prior desktops, such as my [[https://git.sr.ht/~cyborg/dotfiles][dotfiles]]. * Resolving Issues diff --git a/content/blog/2023-02-02-exploring-hare.org b/content/blog/2023-02-02-exploring-hare.org index e7ce0d0..a206ed6 100644 --- a/content/blog/2023-02-02-exploring-hare.org +++ b/content/blog/2023-02-02-exploring-hare.org @@ -50,14 +50,9 @@ page. ** Creating a Test Project -In order to play with the language, I created [[https://github.com/ccleberg/learn-hare][hare-test]] and will be putting any +In order to play with the language, I created [[https://git.sr.ht/~cyborg/learn-hare][hare-test]] and will be putting any of my Hare-related adventures in here. -#+begin_quote -*Update:* I also created a simple Hare program for creating a file from user -input: [[https://github.com/ccleberg/learn-hare/blob/main/files/files.ha][files.ha]] -#+end_quote - Luckily, Hare doesn't require any complex set-up tools or build environment. Once you have Hare installed, you simply need to create a file ending with =.ha= and you can run a Hare program. diff --git a/content/blog/2024-08-11-org-mode-features.org b/content/blog/2024-08-11-org-mode-features.org index e089b51..c8b1e01 100644 --- a/content/blog/2024-08-11-org-mode-features.org +++ b/content/blog/2024-08-11-org-mode-features.org @@ -7,7 +7,7 @@ * Cycling (Folding) #+begin_quote -[[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. +[[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. #+end_quote 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: * TODO Lists #+begin_quote -[[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. +[[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. #+end_quote 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. * Time Stamping #+begin_quote -[[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. +[[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. #+end_quote 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. * Tags #+begin_quote -[[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. +[[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. #+end_quote 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. * Tables #+begin_quote -[[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. +[[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. #+end_quote One of the most inconvenient parts of writing in Markdown was dealing with @@ -232,7 +232,7 @@ on the second line. * Source Code Blocks #+begin_quote -[[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. +[[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. #+end_quote ** Introduction to Source Code Blocks @@ -302,7 +302,7 @@ results below the code block. * Exporting and Publishing #+begin_quote -[[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. +[[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. #+end_quote 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. * Agenda #+begin_quote -[[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. +[[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. #+end_quote Last, but not least, are [[https://orgmode.org/manual/Agenda-Views.html][Agenda Views]]. With agenda views, you can easily view diff --git a/content/now/index.org b/content/now/index.org index 0b3c10b..0e64668 100644 --- a/content/now/index.org +++ b/content/now/index.org @@ -42,4 +42,4 @@ This is a [[https://nownownow.com/about][/now]] page. share online. - Weather has been warming up, so disc golf frequency is increasing. -View the historical [[https://github.com/ccleberg/cleberg.net/commits/main/content/now/index.org][log of changes]] for this page. +View the historical [[https://git.sr.ht/~cyborg/cleberg.net/log/main/item/content/now/index.org][log of changes]] for this page. diff --git a/content/services/index.org b/content/services/index.org index 61c94de..baab06b 100644 --- a/content/services/index.org +++ b/content/services/index.org @@ -34,4 +34,4 @@ | [[https://send.cleberg.net/][Send]] | Simple, private file sharing | | [[https://slash.cleberg.net/][Slash]] | Bookmark and link sharing platform | -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. +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. diff --git a/theme/templates/base.html b/theme/templates/base.html index 0759cd5..576f380 100644 --- a/theme/templates/base.html +++ b/theme/templates/base.html @@ -34,7 +34,7 @@ <p>Last build: <<time datetime="{{ now() | strftime("%Y-%m-%d") }}">{{ now() | strftime("%Y-%m-%d %a %H:%M:%S") }}</time>></p> <p> <a href="https://stats.uptimerobot.com/OwOWs7HU0z">Status</a> · - <a href="https://github.com/ccleberg/cleberg.net" target="_blank" + <a href="https://git.sr.ht/~cyborg/cleberg.net" target="_blank" rel="noopener">Source Code</a> · <a href="/feed.xml">RSS Feed</a> · <a href="/.well-known/security.txt">security.txt</a> diff --git a/theme/templates/index.html b/theme/templates/index.html index 2eab14e..21f2263 100644 --- a/theme/templates/index.html +++ b/theme/templates/index.html @@ -47,7 +47,7 @@ sub rsa4096 2022-11-16 [E]</pre> <li>cyb0rg on <a href="https://libera.chat/">libera.chat</a></li> <li><a href="https://lemmy.cleberg.net/u/cmc">@cmc</a> on Lemmy</li> <li>@cmc.01 on <a href="https://signal.org/">Signal</a></li> - <li><a href="https://github.com/ccleberg">GitHub</a></li> + <li><a href="https://git.sr.ht/~cyborg">Sourcehut</a></li> </ul> </section> |