aboutsummaryrefslogtreecommitdiff
path: root/README.org
diff options
context:
space:
mode:
Diffstat (limited to 'README.org')
-rw-r--r--README.org47
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