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 some I just don't want to put the effort in.
13 
14 This is me reinventing a lightweight literate-programming style (mostly
15 in AWK) and use it to manage my dotfiles, as well as for exporting them
16 for the Geminispace and the WWW.
17 
18 To start using it:
19 
20 	$ ./gen			# generates Makefile.local
21 	$ make install		# installs the dotfiles
22 	$ make publish		# publishes for gemini and www
23 	$ make serve-www	# serve the www site locally
24 	$ make serve-gem	# serve the gemini site locally
25 
26 There are quite a few scripts that I think can be useful to other
27 people:
28 
29 * unpar: gathers paragraphs and simple list that spans multiple lines
30   into a single line; in other words it converts "markdown"-style
31   paragraphs and lists to text/gemini.
32 
33 * gc: converts lines indented with tabs into markdown/gemtext style
34   fenced code blocks.
35 
36 * gem2html: perl script that converts text/gemini to HTML with care.