about summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorFrederik Rietdijk <fridh@fridh.nl>2019-01-19 09:24:01 +0100
committerFrederik Rietdijk <fridh@fridh.nl>2019-01-19 09:24:01 +0100
commitf8b45e2d84a87791aba026d18a098af2cd5e763f (patch)
treef5368d01e8445b02d3aa67efebf721cf7bae1721 /doc
parente7f86448c5e95b130dcdcae61344163d3db02779 (diff)
parentbd538d6bb0a9dd72de7e8717bae705245060c2c4 (diff)
downloadnixlib-f8b45e2d84a87791aba026d18a098af2cd5e763f.tar
nixlib-f8b45e2d84a87791aba026d18a098af2cd5e763f.tar.gz
nixlib-f8b45e2d84a87791aba026d18a098af2cd5e763f.tar.bz2
nixlib-f8b45e2d84a87791aba026d18a098af2cd5e763f.tar.lz
nixlib-f8b45e2d84a87791aba026d18a098af2cd5e763f.tar.xz
nixlib-f8b45e2d84a87791aba026d18a098af2cd5e763f.tar.zst
nixlib-f8b45e2d84a87791aba026d18a098af2cd5e763f.zip
Merge staging-next into staging
Diffstat (limited to 'doc')
-rw-r--r--doc/configuration.xml44
-rw-r--r--doc/reviewing-contributions.xml4
-rw-r--r--doc/style.css24
3 files changed, 64 insertions, 8 deletions
diff --git a/doc/configuration.xml b/doc/configuration.xml
index 624a5bb270ab..8a5ff8dcb8e0 100644
--- a/doc/configuration.xml
+++ b/doc/configuration.xml
@@ -180,7 +180,11 @@
      code:
 <programlisting>
 {
-  allowUnfreePredicate = (pkg: builtins.elem (builtins.parseDrvName pkg.name).name [ "flashplayer" "vscode" ]);
+  allowUnfreePredicate = (pkg: builtins.elem
+    (builtins.parseDrvName pkg.name).name [
+      "flashplayer"
+      "vscode"
+    ]);
 }
 </programlisting>
     </para>
@@ -322,7 +326,18 @@
   packageOverrides = pkgs: with pkgs; {
     myPackages = pkgs.buildEnv {
       name = "my-packages";
-      paths = [ aspell bc coreutils gdb ffmpeg nixUnstable emscripten jq nox silver-searcher ];
+      paths = [
+        aspell
+        bc
+        coreutils
+        gdb
+        ffmpeg
+        nixUnstable
+        emscripten
+        jq
+        nox
+        silver-searcher
+      ];
     };
   };
 }
@@ -343,7 +358,18 @@
   packageOverrides = pkgs: with pkgs; {
     myPackages = pkgs.buildEnv {
       name = "my-packages";
-      paths = [ aspell bc coreutils gdb ffmpeg nixUnstable emscripten jq nox silver-searcher ];
+      paths = [
+        aspell
+        bc
+        coreutils
+        gdb
+        ffmpeg
+        nixUnstable
+        emscripten
+        jq
+        nox
+        silver-searcher
+      ];
       pathsToLink = [ "/share" "/bin" ];
     };
   };
@@ -378,7 +404,17 @@
   packageOverrides = pkgs: with pkgs; {
     myPackages = pkgs.buildEnv {
       name = "my-packages";
-      paths = [ aspell bc coreutils ffmpeg nixUnstable emscripten jq nox silver-searcher ];
+      paths = [
+        aspell
+        bc
+        coreutils
+        ffmpeg
+        nixUnstable
+        emscripten
+        jq
+        nox
+        silver-searcher
+      ];
       pathsToLink = [ "/share/man" "/share/doc" "/bin" ];
       extraOutputsToInstall = [ "man" "doc" ];
     };
diff --git a/doc/reviewing-contributions.xml b/doc/reviewing-contributions.xml
index 5618567e3852..f541b7f22daa 100644
--- a/doc/reviewing-contributions.xml
+++ b/doc/reviewing-contributions.xml
@@ -605,11 +605,11 @@ policy.
 -->
 
   <para>
-   In a case a contributor leaves definitively the Nix community, he should
+   In a case a contributor definitively leaves the Nix community, they should
    create an issue or post on
    <link
    xlink:href="https://discourse.nixos.org">Discourse</link> with
-   references of packages and modules he maintains so the maintainership can be
+   references of packages and modules they maintain so the maintainership can be
    taken over by other contributors.
   </para>
  </section>
diff --git a/doc/style.css b/doc/style.css
index 0db907815b6b..474dd32e3fb1 100644
--- a/doc/style.css
+++ b/doc/style.css
@@ -9,6 +9,7 @@
 body
 {
     font-family: "Nimbus Sans L", sans-serif;
+    font-size: 1em;
     background: white;
     margin: 2em 1em 2em 1em;
 }
@@ -28,6 +29,25 @@ h2 /* chapters, appendices, subtitle */
     font-size: 180%;
 }
 
+div.book
+{
+    text-align: center;
+}
+
+div.book > div
+{
+    /*
+     * based on https://medium.com/@zkareemz/golden-ratio-62b3b6d4282a
+     * we do 70 characters per line to fit code listings better
+     * 70 * (font-size / 1.618)
+     * expression for emacs:
+     * (* 70 (/ 1 1.618))
+     */
+    max-width: 43.2em;
+    text-align: left;
+    margin: auto;
+}
+
 /* Extra space between chapters, appendices. */
 div.chapter > div.titlepage h2, div.appendix > div.titlepage h2
 {
@@ -102,8 +122,8 @@ pre.screen, pre.programlisting
 {
     border: 1px solid #b0b0b0;
     padding: 3px 3px;
-    margin-left: 1.5em;
-    margin-right: 1.5em;
+    margin-left: 0.5em;
+    margin-right: 0.5em;
 
     background: #f4f4f8;
     font-family: monospace;