blob: 116185db5c4efd1d2df6c5a66cfb3492433769ff (
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
|
#+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][cgit]] (raw), or on [[https://cleberg.net/README.html][my website]] (html).
** Overview
This website & blog uses [[https://orgmode.org/][Org-Mode]], published with =org-publish=.
** Configuration
In order to configure the project for publishing, add the following code to your =~/.emacs= file (for Doom, =~/.doom.d/config.el=).
#+begin_src lisp
;; org-publish
(require 'ox-publish)
(setq org-publish-project-alist
`(("blog"
:base-directory "~/Source/cleberg.net/"
:base-extension "org"
:recursive t
:publishing-directory "~/Source/cleberg.net/public/"
:publishing-function org-html-publish-to-html)
;; HTML5
:html-doctype "html5"
:html-html5-fancy t
;; Disable some Org's HTML defaults
:html-head-include-scripts nil
:html-head-include-default-style nil
;; Generate sitemap
:auto-sitemap t
:sitemap-filename "sitemap.org"
;; Customize head, preamble, & postamble
:html-head "<link rel='stylesheet' href='/static/styles.css' type='text/css'>"
:html-preamble ""
:html-postamble ""
("static"
:base-directory "~/Source/cleberg.net/static/"
:base-extension "css\\|txt\\|jpg\\|gif\\|png"
:recursive t
:publishing-directory "~/Source/cleberg.net/public/"
:publishing-function org-publish-attachment)
("cleberg.net" :components ("blog" "static"))));; org-publish
(require 'ox-publish)
#+end_src
** Building
Local testing can be done via [[https://www.gnu.org/software/emacs/][Emacs]].
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=. Once a file has been opened, you can publish the project with =C-c C-e P a=.
If you need to re-publish unchanged files, I recommend using the following command:
#+begin_src lisp
M-: (org-publish "project name" t)
#+end_src
The files will be published to the =public= directory.
** Tasks
*** TODO Create RSS feed
Possible Solution: [[https://writepermission.com/org-blogging-rss-feed.html][Org mode blogging: RSS feed]]
Possible Solution: [[https://www.zoraster.org/blog/script-to-generate-rss-feed][Script to Generate RSS Feeds]]
*** TODO Format all blog posts with =M q=
*** TODO Create script to auto-generate the =/blog/= list and =/= most recent posts
Possible Solution: [[https://taingram.org/blog/org-mode-blog.html#orgde61a58][Sitemap]]
*** TODO Figure out how to get filetags to show up
|
