aboutsummaryrefslogtreecommitdiff
path: root/README.org
blob: 502e7ee23d25ad4de02cfc983f6f13b0d6d34d0f (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
#+title: README
#+description: Project README.

* cleberg.net

[[https://cleberg.net][cleberg.net]] is my personal webpage.

This README is viewable on [[https://git.cleberg.net/?p=cleberg.net.git;a=blob;f=README.org;h=155f4696a09503411730afc422b7fb49acbef8f3;hb=HEAD][rgit]].

** Overview

This website & blog uses [[https://orgmode.org/][Org-Mode]], published with [[https://github.com/emacs-love/weblorg][weblorg]].

** Configuration

Everything is configured within the =publish.el= file. Refer to the weblorg
documentation for further configuration options.

** Building

Local testing can be done via [[https://www.gnu.org/software/emacs/][Emacs]] or through the command line.

To get running:

#+begin_src shell
git clone https://git.cleberg.net/cleberg.net.git && \
cd cleberg.net && \
emacs -nw
#+end_src

Within Emacs, open any of the repository files. In Doom, I do this with =Spc f
f= and selecting =README.org=. Make any changes necessary to customize the
project.

To publish, you can use the =build.sh= script (change the deployment target!) or
you can run the following commands.

Use the =ENV= environment variable to determine which base URL weblorg will use.
If ENV is ommitted, 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
ENV=prod emacs --script publish.el
#+end_src

The files will be published to the =.build= directory. You can deploy these
files to the target through any number of methods, such as =scp= or SFTP.

** Tasks

*** DONE Create RSS feed
*** TODO Format all blog posts with =M q=
*** DONE Create script to auto-generate the =/blog/= list and =/= most recent posts
*** TODO Figure out how to get filetags to show up