Update docs

author: Case Duckworth 2020-05-30 16:46:04 -0500
committer: Case Duckworth 2020-05-30 16:46:04 -0500
commit: 0f87b59ee63bf2e21cc38924450f5d8299883025 (patch)
tree: af224c85aa2dea9f9b4d4e0a8be07b82960841c9 /bollux.conf.5
parent: Change margin stuff (diff)
download: bollux-0f87b59ee63bf2e21cc38924450f5d8299883025.tar.gz
bollux-0f87b59ee63bf2e21cc38924450f5d8299883025.zip
1 files changed, 57 insertions, 0 deletions
diff --git a/bollux.conf.5 b/bollux.conf.5
index eada1de..291dd42 100644
--- a/bollux.conf.5
+++ b/bollux.conf.5

@@ -54,6 +54,63 @@ suppresses even error-level messages.
 I'm going to be honest,
 the difference between the levels is somewhat arbitrary.
 So.
+.SS Typesetting
+.BR bollux (1)
+typesets text/gemini content using the
+.I typeset_gemini
+function.
+While it's probably possible to redefine the function in
+.BR bollux.conf (5),
+the default function is pretty nice (at least in my opinion).
+The following variables control how text/gemini content is rendered:
+.TP
+.BR T_MARGIN " valid values are integers; default is 4."
+The left margin for text.
+Should be at least 3, since line-markers will be displayed in the left margin.
+.TP
+.BR T_WIDTH " valid values are integers; default is 0."
+The total width of the window, including
+.BR T_MARGIN .
+If set to 0, attempts to use the width of the terminal,
+falling back to 80.
+.SS Colors
+The different line-types in text/gemini documents are rendered with
+.I m-class
+terminal escapes (e.g., '\\e[31m').
+The following variables should hold the values between
+.I \\e[
+and
+.IR m ,
+meaning valid values are anything between those that are valid terminal
+color escapes.
+.TP
+.BR C_SIGIL " default: 35 (fg: magenta)"
+The color of the line type as defined by text/gemini.
+.TP
+.BR C_LINK_NUMBER " default: 1 (bold)"
+The color of the link number added by typeset_gemini.
+.TP
+.BR C_LINK_TITLE " default: 4 (underline)"
+The color of the link's title, or if titleless, the URL.
+.TP
+.BR C_LINK_URL " default: 36 (fg: cyan)"
+The color of the link's URL.
+If the link doesn't have a title, this isn't used.
+.TP
+.BI C_HEADER "x where x is 1, 2, or 3"
+The color of text/gemini headers.
+The default for level 1 is
+.IR 1;4 ,
+for level 2 is
+.IR 1 ,
+for level 3 is
+.IR 3 .
+.TP
+.BR C_LIST " default: 0 (no formatting)"
+The color of list items.
+.TP
+.BR C_PRE " default: 0 (no formatting)"
+The color of preformatted lines, as delimited by '```'.
 .SS Variables that could be configured, but probably shouldn't be
 These variables control deeper aspects of
 .BR bollux (1)'s
author	Case Duckworth	2020-05-30 16:46:04 -0500
committer	Case Duckworth	2020-05-30 16:46:04 -0500
commit	0f87b59ee63bf2e21cc38924450f5d8299883025 (patch)
tree	af224c85aa2dea9f9b4d4e0a8be07b82960841c9 /bollux.conf.5
parent	Change margin stuff (diff)
download	bollux-0f87b59ee63bf2e21cc38924450f5d8299883025.tar.gz bollux-0f87b59ee63bf2e21cc38924450f5d8299883025.zip

diff --git a/bollux.conf.5 b/bollux.conf.5 index eada1de..291dd42 100644 --- a/bollux.conf.5 +++ b/bollux.conf.5
@@ -54,6 +54,63 @@ suppresses even error-level messages.
54	I'm going to be honest,	54	I'm going to be honest,
55	the difference between the levels is somewhat arbitrary.	55	the difference between the levels is somewhat arbitrary.
56	So.	56	So.
		57	.SS Typesetting
		58	.BR bollux (1)
		59	typesets text/gemini content using the
		60	.I typeset_gemini
		61	function.
		62	While it's probably possible to redefine the function in
		63	.BR bollux.conf (5),
		64	the default function is pretty nice (at least in my opinion).
		65	The following variables control how text/gemini content is rendered:
		66	.TP
		67	.BR T_MARGIN " valid values are integers; default is 4."
		68	The left margin for text.
		69	Should be at least 3, since line-markers will be displayed in the left margin.
		70	.TP
		71	.BR T_WIDTH " valid values are integers; default is 0."
		72	The total width of the window, including
		73	.BR T_MARGIN .
		74	If set to 0, attempts to use the width of the terminal,
		75	falling back to 80.
		76	.SS Colors
		77	The different line-types in text/gemini documents are rendered with
		78	.I m-class
		79	terminal escapes (e.g., '\\e[31m').
		80	The following variables should hold the values between
		81	.I \\e[
		82	and
		83	.IR m ,
		84	meaning valid values are anything between those that are valid terminal
		85	color escapes.
		86	.TP
		87	.BR C_SIGIL " default: 35 (fg: magenta)"
		88	The color of the line type as defined by text/gemini.
		89	.TP
		90	.BR C_LINK_NUMBER " default: 1 (bold)"
		91	The color of the link number added by typeset_gemini.
		92	.TP
		93	.BR C_LINK_TITLE " default: 4 (underline)"
		94	The color of the link's title, or if titleless, the URL.
		95	.TP
		96	.BR C_LINK_URL " default: 36 (fg: cyan)"
		97	The color of the link's URL.
		98	If the link doesn't have a title, this isn't used.
		99	.TP
		100	.BI C_HEADER "x where x is 1, 2, or 3"
		101	The color of text/gemini headers.
		102	The default for level 1 is
		103	.IR 1;4 ,
		104	for level 2 is
		105	.IR 1 ,
		106	for level 3 is
		107	.IR 3 .
		108	.TP
		109	.BR C_LIST " default: 0 (no formatting)"
		110	The color of list items.
		111	.TP
		112	.BR C_PRE " default: 0 (no formatting)"
		113	The color of preformatted lines, as delimited by '```'.
57	.SS Variables that could be configured, but probably shouldn't be	114	.SS Variables that could be configured, but probably shouldn't be
58	These variables control deeper aspects of	115	These variables control deeper aspects of
59	.BR bollux (1)'s	116	.BR bollux (1)'s