manual: limit text width

Currently the manual scales to the view port of the browser.
This leads to an unreadable layout and I found myself
reading the xml source instead.
The optimal width would be around 50 characters per line.
Since we have code listings also in the manual I relaxed
this limit a bit towards 70 characters per line.

+62 -6
+40 -4
doc/configuration.xml
··· 180 180 code: 181 181 <programlisting> 182 182 { 183 - allowUnfreePredicate = (pkg: builtins.elem (builtins.parseDrvName pkg.name).name [ "flashplayer" "vscode" ]); 183 + allowUnfreePredicate = (pkg: builtins.elem 184 + (builtins.parseDrvName pkg.name).name [ 185 + "flashplayer" 186 + "vscode" 187 + ]); 184 188 } 185 189 </programlisting> 186 190 </para> ··· 322 326 packageOverrides = pkgs: with pkgs; { 323 327 myPackages = pkgs.buildEnv { 324 328 name = "my-packages"; 325 - paths = [ aspell bc coreutils gdb ffmpeg nixUnstable emscripten jq nox silver-searcher ]; 329 + paths = [ 330 + aspell 331 + bc 332 + coreutils 333 + gdb 334 + ffmpeg 335 + nixUnstable 336 + emscripten 337 + jq 338 + nox 339 + silver-searcher 340 + ]; 326 341 }; 327 342 }; 328 343 } ··· 343 358 packageOverrides = pkgs: with pkgs; { 344 359 myPackages = pkgs.buildEnv { 345 360 name = "my-packages"; 346 - paths = [ aspell bc coreutils gdb ffmpeg nixUnstable emscripten jq nox silver-searcher ]; 361 + paths = [ 362 + aspell 363 + bc 364 + coreutils 365 + gdb 366 + ffmpeg 367 + nixUnstable 368 + emscripten 369 + jq 370 + nox 371 + silver-searcher 372 + ]; 347 373 pathsToLink = [ "/share" "/bin" ]; 348 374 }; 349 375 }; ··· 378 404 packageOverrides = pkgs: with pkgs; { 379 405 myPackages = pkgs.buildEnv { 380 406 name = "my-packages"; 381 - paths = [ aspell bc coreutils ffmpeg nixUnstable emscripten jq nox silver-searcher ]; 407 + paths = [ 408 + aspell 409 + bc 410 + coreutils 411 + ffmpeg 412 + nixUnstable 413 + emscripten 414 + jq 415 + nox 416 + silver-searcher 417 + ]; 382 418 pathsToLink = [ "/share/man" "/share/doc" "/bin" ]; 383 419 extraOutputsToInstall = [ "man" "doc" ]; 384 420 };
+22 -2
doc/style.css
··· 9 9 body 10 10 { 11 11 font-family: "Nimbus Sans L", sans-serif; 12 + font-size: 1em; 12 13 background: white; 13 14 margin: 2em 1em 2em 1em; 14 15 } ··· 26 27 h2 /* chapters, appendices, subtitle */ 27 28 { 28 29 font-size: 180%; 30 + } 31 + 32 + div.book 33 + { 34 + text-align: center; 35 + } 36 + 37 + div.book > div 38 + { 39 + /* 40 + * based on https://medium.com/@zkareemz/golden-ratio-62b3b6d4282a 41 + * we do 70 characters per line to fit code listings better 42 + * 70 * (font-size / 1.618) 43 + * expression for emacs: 44 + * (* 70 (/ 1 1.618)) 45 + */ 46 + max-width: 43.2em; 47 + text-align: left; 48 + margin: auto; 29 49 } 30 50 31 51 /* Extra space between chapters, appendices. */ ··· 102 122 { 103 123 border: 1px solid #b0b0b0; 104 124 padding: 3px 3px; 105 - margin-left: 1.5em; 106 - margin-right: 1.5em; 125 + margin-left: 0.5em; 126 + margin-right: 0.5em; 107 127 108 128 background: #f4f4f8; 109 129 font-family: monospace;