diff options
Diffstat (limited to 'README.org')
-rw-r--r-- | README.org | 47 |
1 files changed, 47 insertions, 0 deletions
diff --git a/README.org b/README.org new file mode 100644 index 0000000..6507aa9 --- /dev/null +++ b/README.org @@ -0,0 +1,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 |