1 # dotfiles
2 
3 Welcome to my new-new-new dotfiles repository!
4 
5 My last attempt to manage them was with org-mode, a terrific Emacs lisp
6 program.  It's really cool, but I never wanted to invest time in
7 learning it properly, so here we are.  I guess I could cite Ken Thompson
8 
9 > I can't understand something presented to me that's very complex.
10 
11 but it wouldn't be completely true.  I understand and use complex stuff,
12 but for some I just don't want to put the effort in.  org-mode falls
13 into this category.
14 
15 This is me reinventing a lightweight literate-programming style (mostly
16 in AWK) and use it to manage my dotfiles, as well as for exporting them
17 for the Geminispace and the WWW.
18 
19 To start using it:
20 
21 	$ ./gen			# generates Makefile.local
22 	$ make install		# installs the dotfiles
23 	$ make publish		# publishes for gemini and www
24 	$ make serve-www	# serve the www site locally
25 	$ make serve-gem	# serve the gemini site locally
26 
27 There are quite a few scripts that I think can be useful to other
28 people:
29 
30 * unpar: gathers paragraphs and simple list that spans multiple lines
31   into a single line; in other words it converts "markdown"-style
32   paragraphs and lists to text/gemini.
33 
34 * gc: converts lines indented with tabs into markdown/gemtext style
35   fenced code blocks.
36 
37 * gem2html: perl script that converts text/gemini to HTML with care.