blob: 6507aa927ef8c589f6631314d8cde40e334e5e4d (
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
|
#+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/cleberg.net.git/tree/README.org][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
|
