Fix build/preview scripts

Update configuration for Antora 3.0
build & preview: Update with latest version from template
2022-03-09 16:46:08 +01:00 · 2022-03-09 16:46:08 +01:00 · 2022-03-09 16:46:08 +01:00 · 2018-07-28 14:50:53 +02:00 · 2018-07-28 13:15:11 +02:00 · 2018-07-28 11:32:13 +02:00
75 changed files with 490 additions and 1742 deletions
--- a/.gitignore
+++ b/.gitignore
@ -1,9 +1,3 @@
-## AsciiBinder-specific ignores
-_preview
-_package
-*.swp
-diag-*.png
-diag-*.png.cache
-
-## Project-specific ignores
-
+build
+cache
+public
--- a/README.md
+++ b/README.md
@ -1,41 +1,43 @@
-# Fedora Release Notes
+# Fedora Modularity Docs

-This is the content repository for the Fedora Installation Guide.
+Please report Issues and submit Pull Requests for **Content Fixes** here.
+Never done a pull request (or "PR")? Here's the [Pagure documentation for
+Pull Requests](https://docs.pagure.org/pagure/usage/pull_requests.html).

-Please report Issues and submit Pull Requests for **Content Fixes** here.  General appearance issues and publishing issues should be reported against the [publisher](https://pagure.io/fedora-docs/docs-fp-o).

-## README for contributors
+General appearance issues and publishing issues should be reported against
+the [publishing software](https://pagure.io/fedora-docs/docs-fp-o).

-Refer to https://fedoraproject.org/wiki/Category:Documentation_beats?rd=Docs/Beats
-for content; proofread when adding to git and mark sections and wiki pages as
-complete as you progress.
+## How to edit these documents

-Use `create-tx-configuration` to maintain .tx/config (thanks Sparks!)
+All of this is written in AsciiDoc. It's a simple mostly-plain-text
+markup language. You may want to look at:

-When shipping an RPM, test, pull POs, test again, tag, bump spec, and build. See
-https://fedoraproject.org/wiki/User:Immanetize/Packaging_Docs_in_an_RPM for
-detailed instructions.

-Some methods of finding new packages to write about:
-https://bodhi.fedoraproject.org/updates/new
-https://bodhi.fedoraproject.org/updates/?release=F25&type=newpackage
-`bodhi -r f25 -t newpackage`
-#~/usr/bin/env python 
-from fedora.client import BodhiClient; BodhiClient().query(release="F25", type_="newpackage")
+* [AsciiDoc Syntax Quick Reference](http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/)
+* [AsciiDoc Writer’s  Guide](http://asciidoctor.org/docs/asciidoc-writers-guide/)
+* [Antora Documentation](https://docs.antora.org/antora/1.0/page/)

-## How to edit this document

-This document is coded in AsciiDoc.  The content is in the en-US directory.  There is a shared entity file in the en-US directory.  Do not edit the content in the Common_Content directory.
+## Local preview

-## Testing your changes locally
+This repo includes scripts to build and preview the contents of this repository.

-To test your changes, first install `asciibinder`
+**NOTE**: Please note that if you reference pages from other repositoreis, such links will be broken in this local preview as it only builds this repository. If you want to rebuild the whole Fedora Docs site, please see [the Fedora Docs build repository](https://pagure.io/fedora-docs/docs-fp-o/) for instructions.

-$ gem install ascii_binder
+Both scripts use docker, so please make sure you have it installed on your system. Please see below for instructions.

-To build your changes, from the root directory:
+To build and preview the site, run:

 ```
-$ asciibinder package
-$ firefox _package/main/index.html
+$ ./build.sh && ./preview.sh
+```
+
+The result will be available at http://localhost:8080
+
+### Installing docker on Fedora
+
+```
+$ sudo dnf install docker
+$ sudo systemctl start docker && sudo systemctl enable docker
 ```
--- a/_distro_map.yml
+++ b/_distro_map.yml
@ -1,14 +0,0 @@
---
-fedora:
-  name: Fedora Release Notes
-  author: Fedora Documentation Project <docs@lists.fedoraproject.org>
-  site: main
-  site_name: Home
-  site_url: https://docs.fedoraproject.org/
-  branches:
-    master:
-      name: Rawhide
-      dir: rawhide
-    f26:
-      name: 26
-      dir: f26
--- a/_images/favicon.ico
+++ b/_images/favicon.ico
--- a/_images/favicon32x32.png
+++ b/_images/favicon32x32.png
--- a/_images/fedora.svg
+++ b/_images/fedora.svg
@ -1,61 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!-- Created with Inkscape (http://www.inkscape.org/) -->
-
-<svg
-   xmlns:svg="http://www.w3.org/2000/svg"
-   xmlns="http://www.w3.org/2000/svg"
-   version="1.0"
-   width="220"
-   height="70"
-   id="svg6180">
-  <defs
-     id="defs6182" />
-  <g
-     transform="translate(-266.55899,-345.34488)"
-     id="layer1">
-    <path
-       d="m 316.7736,397.581 c 0,0 0,0 -20.53889,0 0.3327,4.45245 3.92157,7.77609 8.70715,7.77609 3.38983,0 6.31456,-1.39616 8.64094,-3.65507 0.46553,-0.46679 0.99726,-0.59962 1.59519,-0.59962 0.79781,0 1.59561,0.39932 2.12692,1.06388 0.3327,0.46553 0.53216,0.99726 0.53216,1.52857 0,0.73118 -0.3327,1.52857 -0.93106,2.12734 -2.7919,2.99052 -7.51086,4.98503 -12.16403,4.98503 -8.44149,0 -15.22074,-6.77967 -15.22074,-15.22158 0,-8.44149 6.58022,-15.22074 15.02171,-15.22074 8.37529,0 14.62323,6.51317 14.62323,15.08749 0,1.26418 -1.12924,2.12861 -2.39258,2.12861 z m -12.23065,-11.76512 c -4.45329,0 -7.51085,2.92473 -8.17499,7.17731 10.03626,0 16.35083,0 16.35083,0 -0.59836,-4.05355 -3.78874,-7.17731 -8.17584,-7.17731 z"
-       id="path11"
-       style="fill:#3c6eb4" />
-    <path
-       d="m 375.46344,410.80807 c -8.44106,0 -15.22074,-6.77968 -15.22074,-15.22159 0,-8.44149 6.77968,-15.22074 15.22074,-15.22074 8.44234,0 15.22159,6.77925 15.22159,15.22074 -4.2e-4,8.44149 -6.77968,15.22159 -15.22159,15.22159 z m 0,-24.65992 c -5.31688,0 -8.77377,4.25427 -8.77377,9.43833 0,5.18364 3.45689,9.43833 8.77377,9.43833 5.31731,0 8.77504,-4.25469 8.77504,-9.43833 -4.2e-4,-5.18406 -3.45773,-9.43833 -8.77504,-9.43833 z"
-       id="path13"
-       style="fill:#3c6eb4" />
-    <path
-       d="m 412.66183,380.36574 c -4.45963,0 -7.40966,1.319 -10.01391,4.62956 l -0.24036,-1.53995 0,0 c -0.20198,-1.60743 -1.57326,-2.84926 -3.23382,-2.84926 -1.80139,0 -3.26206,1.459 -3.26206,3.26081 0,0.003 0,0.005 0,0.008 l 0,0 0,0.003 0,0 0,23.40712 c 0,1.79464 1.46194,3.25743 3.257,3.25743 1.79465,0 3.25744,-1.46279 3.25744,-3.25743 l 0,-12.56209 c 0,-5.71621 4.98502,-8.57432 10.23613,-8.57432 1.59519,0 2.85726,-1.32953 2.85726,-2.92515 0,-1.59561 -1.26207,-2.85726 -2.85768,-2.85726 z"
-       id="path15"
-       style="fill:#3c6eb4" />
-    <path
-       d="m 447.02614,395.58648 c 0.0666,-8.17541 -5.78326,-15.22074 -15.222,-15.22074 -8.44192,0 -15.28779,6.77925 -15.28779,15.22074 0,8.44191 6.64684,15.22159 14.68985,15.22159 4.01434,0 7.62682,-2.06621 9.23846,-4.22518 l 0.79359,2.01434 0,0 c 0.42589,1.13177 1.5176,1.93717 2.7978,1.93717 1.65001,0 2.98756,-1.33671 2.99009,-2.98545 l 0,0 0,-7.80687 0,0 0,-4.1556 z m -15.222,9.43833 c -5.31773,0 -8.77419,-4.25469 -8.77419,-9.43833 0,-5.18406 3.45604,-9.43833 8.77419,-9.43833 5.3173,0 8.77419,4.25427 8.77419,9.43833 0,5.18364 -3.45689,9.43833 -8.77419,9.43833 z"
-       id="path17"
-       style="fill:#3c6eb4" />
-    <path
-       d="m 355.01479,368.3337 c 0,-1.7938 -1.46194,-3.18997 -3.25659,-3.18997 -1.79422,0 -3.25743,1.39659 -3.25743,3.18997 l 0,17.1499 c -1.66097,-3.05756 -5.25026,-5.11786 -9.50495,-5.11786 -8.64052,0 -14.42336,6.51318 -14.42336,15.22074 0,8.70757 5.98229,15.22159 14.42336,15.22159 3.76555,0 7.03057,-1.55429 8.98587,-4.25554 l 0.72317,1.83428 c 0.44782,1.25912 1.64917,2.16024 3.06051,2.16024 1.78621,0 3.24984,-1.45435 3.24984,-3.24815 0,-0.005 0,-0.009 0,-0.0139 l 0,0 0,-38.95128 -4.2e-4,0 z m -15.22116,36.69111 c -5.31731,0 -8.70715,-4.25469 -8.70715,-9.43833 0,-5.18406 3.38984,-9.43833 8.70715,-9.43833 5.31773,0 8.70714,4.0544 8.70714,9.43833 0,5.38309 -3.38941,9.43833 -8.70714,9.43833 z"
-       id="path19"
-       style="fill:#3c6eb4" />
-    <path
-       d="m 287.21553,365.34023 c -0.59414,-0.0877 -1.19966,-0.13198 -1.80097,-0.13198 -6.73118,0 -12.20746,5.4767 -12.20746,12.20788 l 0,3.8132 -3.98903,0 c -1.46237,0 -2.65908,1.19671 -2.65908,2.65781 0,1.46321 1.19671,2.93738 2.65908,2.93738 l 3.98819,0 0,20.46004 c 0,1.79464 1.46236,3.25743 3.25658,3.25743 1.79507,0 3.25744,-1.46279 3.25744,-3.25743 l 0,-20.46004 4.40986,0 c 1.46194,0 2.65823,-1.47417 2.65823,-2.93738 0,-1.46152 -1.19629,-2.65823 -2.65823,-2.65823 l -4.40733,0 0,-3.8132 c 0,-3.13852 2.55323,-6.11469 5.69175,-6.11469 0.28294,0 0.56757,0.0211 0.84672,0.062 1.78031,0.26355 3.4358,-0.54269 3.70019,-2.32342 0.2627,-1.77904 -0.96606,-3.43538 -2.74594,-3.69935 z"
-       id="path21"
-       style="fill:#3c6eb4" />
-    <path
-       d="m 482.01243,363.57426 c 0,-10.06788 -8.16108,-18.22938 -18.22897,-18.22938 -10.06282,0 -18.22179,8.15475 -18.22854,18.21631 l -4.2e-4,-4.2e-4 0,14.1071 4.2e-4,4.2e-4 c 0.005,2.28463 1.85832,4.13409 4.14463,4.13409 0.007,0 0.0127,-8.4e-4 0.0194,-8.4e-4 l 0.001,8.4e-4 14.07083,0 0,0 c 10.06409,-0.004 18.22138,-8.16276 18.22138,-18.22812 z"
-       id="path25"
-       style="fill:#294172" />
-    <path
-       d="m 469.13577,349.66577 c -4.72528,0 -8.55576,3.83049 -8.55576,8.55577 0,0.002 0,0.004 0,0.006 l 0,4.52836 -4.51444,0 c -8.5e-4,0 -8.5e-4,0 -0.001,0 -4.72528,0 -8.55576,3.81193 -8.55576,8.53678 0,4.72528 3.83048,8.55577 8.55576,8.55577 4.72486,0 8.55534,-3.83049 8.55534,-8.55577 0,-0.002 0,-0.004 0,-0.006 l 0,-4.54733 4.51444,0 c 8.5e-4,0 0.001,0 0.002,0 4.72486,0 8.55534,-3.79296 8.55534,-8.51781 0,-4.72528 -3.83048,-8.55577 -8.55534,-8.55577 z m -8.55576,21.63483 c -0.004,2.48998 -2.02446,4.50811 -4.51571,4.50811 -2.49378,0 -4.53426,-2.02193 -4.53426,-4.5157 0,-2.49421 2.04048,-4.55366 4.53426,-4.55366 0.002,0 0.004,4.2e-4 0.006,4.2e-4 l 3.86971,0 c 0.001,0 0.002,-4.2e-4 0.003,-4.2e-4 0.35209,0 0.63799,0.28505 0.63799,0.63715 0,4.2e-4 -4.2e-4,8.4e-4 -4.2e-4,0.001 l 0,3.92284 -4.2e-4,0 z m 8.55534,-8.5448 c -0.001,0 -0.003,0 -0.004,0 l -3.87223,0 c -8.4e-4,0 -0.002,0 -0.002,0 -0.35252,0 -0.63757,-0.28506 -0.63757,-0.63758 l 0,-4.2e-4 0,-3.90343 c 0.004,-2.49083 2.02446,-4.50854 4.51571,-4.50854 2.49378,0 4.53468,2.02193 4.53468,4.51613 4.2e-4,2.49336 -2.04048,4.53384 -4.53426,4.53384 z"
-       id="path29"
-       style="fill:#3c6eb4" />
-    <path
-       d="m 460.58001,362.7558 0,-4.52836 c 0,-0.002 0,-0.004 0,-0.006 0,-4.72528 3.83048,-8.55577 8.55576,-8.55577 0.71685,0 1.22623,0.0805 1.88952,0.25469 0.96774,0.25385 1.75796,1.04618 1.75838,1.96922 4.2e-4,1.11575 -0.80919,1.92621 -2.0194,1.92621 -0.57642,0 -0.78473,-0.11048 -1.62892,-0.11048 -2.49125,0 -4.51149,2.01771 -4.51571,4.50854 l 0,3.90385 0,4.2e-4 c 0,0.35252 0.28505,0.63758 0.63757,0.63758 4.3e-4,0 0.001,0 0.002,0 l 2.96521,0 c 1.10521,0 1.99747,0.88467 1.99832,1.99283 0,1.10816 -0.89353,1.99114 -1.99832,1.99114 l -3.60489,0 0,4.54733 c 0,0.002 0,0.004 0,0.006 0,4.72485 -3.83048,8.55534 -8.55534,8.55534 -0.71684,0 -1.22623,-0.0805 -1.88952,-0.25469 -0.96774,-0.25343 -1.75838,-1.04618 -1.7588,-1.9688 0,-1.11575 0.80919,-1.92663 2.01982,-1.92663 0.576,0 0.78473,0.11048 1.6285,0.11048 2.49125,0 4.51191,-2.01771 4.51613,-4.50811 0,0 0,-3.92368 0,-3.9241 0,-0.35168 -0.2859,-0.63673 -0.63799,-0.63673 -4.3e-4,0 -8.5e-4,0 -0.002,0 l -2.96521,-4.2e-4 c -1.10521,0 -1.99831,-0.88214 -1.99831,-1.9903 -4.3e-4,-1.11533 0.90238,-1.99367 2.01939,-1.99367 l 3.58339,0 0,0 z"
-       id="path31"
-       style="fill:#ffffff" />
-    <path
-       d="m 477.41661,378.55292 2.81558,0 0,0.37898 -1.18152,0 0,2.94935 -0.45254,0 0,-2.94935 -1.18152,0 0,-0.37898 m 3.26144,0 0.67101,0 0.84937,2.26496 0.85381,-2.26496 0.67102,0 0,3.32833 -0.43917,0 0,-2.9226 -0.85828,2.28279 -0.45255,0 -0.85827,-2.28279 0,2.9226 -0.43694,0 0,-3.32833"
-       id="text6223"
-       style="fill:#294172;enable-background:new" />
-  </g>
-  <path
-     d="m 181.98344,61.675273 2.81558,0 0,0.37898 -1.18152,0 0,2.94935 -0.45254,0 0,-2.94935 -1.18152,0 0,-0.37898 m 3.26144,0 0.67101,0 0.84937,2.26496 0.85381,-2.26496 0.67102,0 0,3.32833 -0.43917,0 0,-2.9226 -0.85828,2.28279 -0.45255,0 -0.85827,-2.28279 0,2.9226 -0.43694,0 0,-3.32833"
-     id="path2391"
-     style="fill:#294172;enable-background:new" />
-</svg>
--- a/_images/redhat-logo.png
+++ b/_images/redhat-logo.png
--- a/_javascripts/.gitkeep
+++ b/_javascripts/.gitkeep
--- a/_javascripts/bootstrap-offcanvas.js
+++ b/_javascripts/bootstrap-offcanvas.js
@ -1,6 +0,0 @@
-$(document).ready(function () {
-  $('[data-toggle="offcanvas"]').click(function () {
-    $('.sidebar').show();
-    $('.row-offcanvas').toggleClass('active');
-  });
-});
--- a/_stylesheets/asciibinder.css
+++ b/_stylesheets/asciibinder.css
@ -1,568 +0,0 @@
-@import url(https://maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css);
-/* ------------------------------------------------------------
-Image: "Spin" https://www.flickr.com/photos/eflon/3655695161/
-Author: eflon https://www.flickr.com/photos/eflon/
-License: https://creativecommons.org/licenses/by/2.0/
---------------------------------------------------------------*/
-.attribution {
-  text-align: center;
-  position: relative;
-  bottom: -20px;
-}
-.attribution .btn {
-  color: #808080;
-  color: rgba(175,175,175, .65);
-  font-size: 11px;
-}
-.attribution .btn:hover {
-  text-decoration: none;
-  color: #aaa;
-}
-.popover-content {
-  font-size: 12px;
-  line-height: 1.3;
-  font-weight: normal;
-}
-
-@media screen and (max-width: 980px) {
-  body {
-    margin-bottom: 200px;
-  }
-  footer {
-    text-align: center;
-  }
-  footer .text-right {
-    text-align: center !important;
-  }
-  #footer_social .first {
-    margin-left: 0;
-  }
-  #footer_social > a {
-    top: 24px;
-  }
-}
-
-.fa-inverse:hover {
-  color: #ccc;
-}
-
-.collapse a.active {
-  background-color: #DEEAF4;
-  color: #000;
-  position: relative;
-}
-
-.collapse a.active:hover {
-  text-decoration: none;
-}
-
-.collapse a.active:before {
-  background-color: #A0C3E5;
-  content: "";
-  display: inline-block;
-  height: 100%;
-  left: 0;
-  position: absolute;
-  top: 0;
-  width: 3px;
-}
-
-.main h2, .main .h2 {
-  border-top: 0px;
-  padding-top: 10px;
-}
-
-.page-header {
-  height: 100% !important;
-}
-
-.page-header h2{
-  font-size: 28px;
-}
-
-.navbar-brand {
-  padding: initial;
-  height: initial;
-}
-
-.nav > li  > a.hover{
-  background-color: none;
-}
-
-h1, h2, h3, h4, h5, h6, .h1, .h2, .h3, .h4, .h5, .h6 {
-  position: relative;
-}
-
-h2 > a.anchor, h3 > a.anchor, h4 > a.anchor, h5 > a.anchor, h6 > a.anchor {
-  display: block;
-  font-weight: normal;
-  margin-left: -1.5ex;
-  position: absolute;
-  text-align: center;
-  text-decoration: none !important;
-  visibility: hidden;
-  width: 1.5ex;
-  z-index: 1001;
-}
-
-h2 > a.anchor:before, h3 > a.anchor:before, h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before {
-  content: "\f0c1";
-  display: block;
-  font-family: FontAwesome;
-  font-size: 0.7em;
-  -webkit-font-smoothing: antialiased;
-  -moz-osx-font-smoothing: grayscale;
-  padding-top: 0.2em;
-}
-
-h4 > a.anchor:before, h5 > a.anchor:before, h6 > a.anchor:before {
-  font-size: 1em;
-}
-
-h2:hover > a.anchor,
-h2 > a.anchor:hover,
-h3:hover > a.anchor,
-h3 > a.anchor:hover,
-h4:hover > a.anchor,
-h4 > a.anchor:hover,
-h5:hover > a.anchor,
-h5 > a.anchor:hover,
-h6:hover > a.anchor,
-h6 > a.anchor:hover {
-  visibility: visible;
-}
-
-.main {
-  border-left: 1px solid #e7e7e7;
-  margin-left: -1px;
-  padding-left: 25px;
-}
-
-
-@media (min-width: 768px) {
-  .main {
-    padding-left: 30px;
-  }
-}
-
-/*
- * Sidebar
- */
-
-.nav-header {
-  font-size: 16px;
-}
-
-.nav-header ul {
-  font-size: 14px;
-}
-
-.nav-header ul li a {
-  display: block;
-  padding: 5px 20px 5px 25px;
-  font-size: 13px;
-  font-weight: normal;
-}
-
-.nav-sidebar .fa {
-  text-align: center;
-  top: -1px;
-  width: 14px;
-}
-
-.nav-sidebar li a {
-  color: inherit;
-}
-
-.nav-sidebar li a:hover {
-  color: #000;
-}
-
-.nav-sidebar ul li ul.nav-tertiary li a {
-  padding-left: 50px;
-}
-
-.nav-sidebar > li > a {
-  padding: 7px 0;
-}
-
-.nav-sidebar > li > a:focus, .nav-sidebar > li > a:hover {
-  background: transparent;
-}
-
-.sidebar {
-  font-weight: 300;
-  display: none;
-  padding-top: 13px;
-}
-
-@media screen and (max-width: 767px) {
-  .sidebar {
-    padding-left: 30px;
-    padding-right: 0;
-  }
-}
-
-@media screen and (min-width: 768px) {
-  .sidebar {
-    border-right: 1px solid #e7e7e7;
-    display: block;
-  }
-}
-
-/*
- * Off Canvas
- * --------------------------------------------------
- */
-
-body, html {
-  overflow-x: hidden; /* Prevent scroll on narrow devices */
-}
-
-.toggle-nav {
-  margin-right: 20px;
-}
-
-@media screen and (max-width: 767px) {
-  .row-offcanvas {
-    position: relative;
-    -webkit-transition: all .25s ease-out;
-         -o-transition: all .25s ease-out;
-            transition: all .25s ease-out;
-  }
-
-  .row-offcanvas-right {
-    right: 0;
-  }
-
-  .row-offcanvas-left {
-    left: 0;
-  }
-
-  .row-offcanvas-right
-  .sidebar-offcanvas {
-    right: -75%; /* 8 columns */
-  }
-
-  .row-offcanvas-left
-  .sidebar-offcanvas {
-    left: -75%; /* 8 columns */
-  }
-
-  .row-offcanvas-right.active {
-    right: 75%; /* 8 columns */
-  }
-
-  .row-offcanvas-left.active {
-    left: 75%; /* 8 columns */
-  }
-
-  .sidebar-offcanvas {
-    overflow: hidden;
-    position: absolute;
-    top: 0;
-    width: 75%; /* 8 columns */
-  }
-}
-
- p {
-  margin: 0 0 1.6em;
- }
-
- /* Remnants of Asciidoctor default stylesheet - remove styles as needed */
-
-#map_canvas img, #map_canvas embed, #map_canvas object, .map_canvas img, .map_canvas embed, .map_canvas object { max-width: none !important; }
-.left { float: left !important; }
-.right { float: right !important; }
-.text-left { text-align: left !important; }
-.text-right { text-align: right !important; }
-.text-center { text-align: center !important; }
-.text-justify { text-align: justify !important; }
-.hide { display: none; }
-.subheader, #content #toctitle, .admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { line-height: 1.4; color: #7a2518; font-weight: 300; margin-top: 0.2em; margin-bottom: 0.5em; }
-abbr, acronym { text-transform: uppercase; font-size: 90%; color: #333333; border-bottom: 1px dotted #dddddd; cursor: help; }
-abbr { text-transform: none; }
-blockquote { margin: 0 0 1.25em; padding: 0.5625em 1.25em 0 1.1875em; border-left: 3px solid #487c58; }
-blockquote cite { display: block; font-size: inherit; color: #454545; }
-blockquote cite:before { content: "\2014 \0020"; }
-blockquote cite a, blockquote cite a:visited { color: #454545; }
-blockquote, blockquote p { line-height: 1.6; color: #6e6e6e; }
-@media only screen and (min-width: 768px) {
-  #toctitle, .sidebarblock > .content > .title { line-height: 1.4; }
-  #toctitle, .sidebarblock > .content > .title { font-size: 1.6875em; }
-}
-table { background: white; margin-bottom: 1.25em; border: solid 1px #dddddd; }
-table thead, table tfoot { background: whitesmoke; font-weight: bold; }
-table thead tr th, table thead tr td, table tfoot tr th, table tfoot tr td { padding: 0.5em 0.625em 0.625em; font-size: inherit; color: #333333; text-align: left; }
-table tr th, table tr td { padding: 0.5625em 0.625em; font-size: inherit; color: #333333; }
-table tr.even, table tr.alt, table tr:nth-of-type(even) { background: #f9f9f9; }
-table thead tr th, table tfoot tr th, table tbody tr td, table tr td, table tfoot tr td { display: table-cell; line-height: 1.6; }
-.clearfix:before, .clearfix:after, .float-group:before, .float-group:after { content: " "; display: table; }
-.clearfix:after, .float-group:after { clear: both; }
-*:not(pre) > code { font-size: inherit; padding: 0; white-space: nowrap; background-color: inherit; border: 0 solid #dddddd; -webkit-border-radius: 4px; border-radius: 4px; text-shadow: none; line-height: 1; }
-.keyseq { color: #666666; }
-kbd:not(.keyseq) { display: inline-block; color: #333333; font-size: 0.75em; line-height: 1.4; background-color: #f7f7f7; border: 1px solid #ccc; -webkit-border-radius: 3px; border-radius: 3px; -webkit-box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; box-shadow: 0 1px 0 rgba(0, 0, 0, 0.2), 0 0 0 2px white inset; margin: -0.15em 0.15em 0 0.15em; padding: 0.2em 0.6em 0.2em 0.5em; vertical-align: middle; white-space: nowrap; }
-.keyseq kbd:first-child { margin-left: 0; }
-.keyseq kbd:last-child { margin-right: 0; }
-.menuseq, .menu { color: #1a1a1a; }
-b.button:before, b.button:after { position: relative; top: -1px; font-weight: normal; }
-b.button:before { content: "["; padding: 0 3px 0 2px; }
-b.button:after { content: "]"; padding: 0 2px 0 3px; }
-p a > code:hover { color: #561309; }
-#header, #content, #footnotes, #footer { width: 100%; margin-left: auto; margin-right: auto; margin-top: 0; margin-bottom: 0; max-width: 62.5em; *zoom: 1; position: relative; padding-left: 0.9375em; padding-right: 0.9375em; }
-#header:before, #header:after, #content:before, #content:after, #footnotes:before, #footnotes:after, #footer:before, #footer:after { content: " "; display: table; }
-#header:after, #content:after, #footnotes:after, #footer:after { clear: both; }
-#content:before { content: none; }
-#header { margin-bottom: 2.5em; }
-#header > h1 { color: black; font-weight: 300; border-bottom: 1px solid #d8d8d8; margin-bottom: -28px; padding-bottom: 32px; }
-#header span { color: #6e6e6e; }
-#header #revnumber { text-transform: capitalize; }
-#header br { display: none; }
-#header br + span { padding-left: 3px; }
-#header br + span:before { content: "\2013 \0020"; }
-#header br + span.author { padding-left: 0; }
-#header br + span.author:before { content: ", "; }
-#toc { border-bottom: 3px double #e5e5e5; padding-top: 1em; padding-bottom: 1.25em; }
-#toc > ul { margin-left: 0.25em; }
-#toc ul.sectlevel0 > li > a { font-style: italic; }
-#toc ul.sectlevel0 ul.sectlevel1 { margin-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
-#toc ul { font-family: "Open Sans", "DejaVu Sans", "Sans", sans-serif; list-style-type: none; }
-#toc a { text-decoration: none; }
-#toc a:active { text-decoration: underline; }
-#toctitle { color: #7a2518; }
-@media only screen and (min-width: 768px) { body.toc2 { padding-left: 15em; padding-right: 0; }
-  #toc.toc2 { background-color: #fafaf9; position: fixed; width: 15em; left: 0; top: 0; border-right: 1px solid #e5e5e5; border-bottom: 0; z-index: 1000; padding: 1.25em 1em; height: 100%; overflow: auto; }
-  #toc.toc2 #toctitle { margin-top: 0; font-size: 1.2em; }
-  #toc.toc2 > ul { font-size: .90em; margin-bottom: 0; }
-  #toc.toc2 ul ul { margin-left: 0; padding-left: 1em; }
-  #toc.toc2 ul.sectlevel0 ul.sectlevel1 { padding-left: 0; margin-top: 0.5em; margin-bottom: 0.5em; }
-  body.toc2.toc-right { padding-left: 0; padding-right: 15em; }
-  body.toc2.toc-right #toc.toc2 { border-right: 0; border-left: 1px solid #e5e5e5; left: auto; right: 0; } }
-@media only screen and (min-width: 1280px) { body.toc2 { padding-left: 20em; padding-right: 0; }
-  #toc.toc2 { width: 20em; }
-  #toc.toc2 #toctitle { font-size: 1.375em; }
-  #toc.toc2 > ul { font-size: 0.95em; }
-  #toc.toc2 ul ul { padding-left: 1.25em; }
-  body.toc2.toc-right { padding-left: 0; padding-right: 20em; } }
-#content #toc { border-style: solid; border-width: 1px; border-color: #e3e3dd; margin-bottom: 1.25em; padding: 1.25em; background: #fafaf9; border-width: 0; -webkit-border-radius: 4px; border-radius: 4px; }
-#content #toc > :first-child { margin-top: 0; }
-#content #toc > :last-child { margin-bottom: 0; }
-#content #toctitle { font-size: 1.375em; }
-#footer { max-width: 100%; background-color: #333333; padding: 1.25em; }
-#footer-text { color: #cccccc; line-height: 1.44; }
-.audioblock, .imageblock, .literalblock, .listingblock, .stemblock, .verseblock, .videoblock { margin-bottom: 2.5em; }
-.admonitionblock td.content > .title, .audioblock > .title, .exampleblock > .title, .imageblock > .title, .listingblock > .title, .literalblock > .title, .stemblock > .title, .openblock > .title, .paragraph > .title, .quoteblock > .title, table.tableblock > .title, .verseblock > .title, .videoblock > .title, .dlist > .title, .olist > .title, .ulist > .title, .qlist > .title, .hdlist > .title { text-rendering: optimizeLegibility; text-align: left; font-family: "Noto Serif", "DejaVu Serif", "Serif", serif; font-weight: normal; font-style: italic; }
-table.tableblock > caption.title { white-space: nowrap; overflow: visible; max-width: 0; }
-table.tableblock #preamble > .sectionbody > .paragraph:first-of-type p { font-size: inherit; }
-.admonitionblock > table { border: 0; background: none; width: 100%; }
-.admonitionblock > table td.icon { text-align: center; width: 80px; }
-.admonitionblock > table td.icon img { max-width: none; }
-.admonitionblock > table td.icon .title { font-weight: 300; text-transform: uppercase; }
-.admonitionblock > table td.content { padding-left: 0; padding-right: 1.25em; color: #6e6e6e; }
-.admonitionblock > table td.content > :last-child > :last-child { margin-bottom: 0; }
-.exampleblock > .content { border-style: solid; border-width: 1px; border-color: #e6e6e6; margin-bottom: 1.25em; padding: 1.25em; background: white; -webkit-border-radius: 4px; border-radius: 4px; }
-.exampleblock > .content > :first-child { margin-top: 0; }
-.exampleblock > .content > :last-child { margin-bottom: 0; }
-.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6, .exampleblock > .content p { color: #333333; }
-.exampleblock > .content h1, .exampleblock > .content h2, .exampleblock > .content h3, .exampleblock > .content #toctitle, .sidebarblock.exampleblock > .content > .title, .exampleblock > .content h4, .exampleblock > .content h5, .exampleblock > .content h6 { line-height: 1; margin-bottom: 0.625em; }
-.exampleblock > .content h1.subheader, .exampleblock > .content h2.subheader, .exampleblock > .content h3.subheader, .exampleblock > .content .subheader#toctitle, .sidebarblock.exampleblock > .content > .subheader.title, .exampleblock > .content h4.subheader, .exampleblock > .content h5.subheader, .exampleblock > .content h6.subheader { line-height: 1.4; }
-.exampleblock.result > .content { -webkit-box-shadow: 0 1px 8px #e3e3dd; box-shadow: 0 1px 8px #e3e3dd; }
-.sidebarblock { border-style: solid; border-width: 1px; border-color: #e3e3dd; margin-top: -1.0em; margin-bottom: 1.6em; padding: .5em; background: #F1F3F5; -webkit-border-radius: 4px; border-radius: 4px; overflow-x: auto; }
-.sidebarblock > :first-child { margin-top: 0; }
-.sidebarblock > :last-child { margin-bottom: 0; }
-.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6, .sidebarblock p { color: #333333; }
-.sidebarblock h1, .sidebarblock h2, .sidebarblock h3, .sidebarblock #toctitle, .sidebarblock > .content > .title, .sidebarblock h4, .sidebarblock h5, .sidebarblock h6 { line-height: 1; margin-bottom: 0.625em; }
-.sidebarblock h1.subheader, .sidebarblock h2.subheader, .sidebarblock h3.subheader, .sidebarblock .subheader#toctitle, .sidebarblock > .content > .subheader.title, .sidebarblock h4.subheader, .sidebarblock h5.subheader, .sidebarblock h6.subheader { line-height: 1.4; }
-.sidebarblock > .content > .title { color: #7a2518; margin-top: 0; line-height: 1.6; }
-.exampleblock > .content > :last-child > :last-child, .exampleblock > .content .olist > ol > li:last-child > :last-child, .exampleblock > .content .ulist > ul > li:last-child > :last-child, .exampleblock > .content .qlist > ol > li:last-child > :last-child, .sidebarblock > .content > :last-child > :last-child, .sidebarblock > .content .olist > ol > li:last-child > :last-child, .sidebarblock > .content .ulist > ul > li:last-child > :last-child, .sidebarblock > .content .qlist > ol > li:last-child > :last-child { margin-bottom: 0; }
-.literalblock pre, .literalblock pre[class], .listingblock pre, .listingblock pre[class] { border: 0px; background-color: #F0F3F5; -webkit-border-radius: 5px; border-radius: 5px; padding: 1.5em 2.5em; word-wrap: break-word; }
-.literalblock pre.nowrap, .literalblock pre[class].nowrap, .listingblock pre.nowrap, .listingblock pre[class].nowrap { overflow-x: auto; white-space: pre; word-wrap: normal; }
-.literalblock pre > code, .literalblock pre[class] > code, .listingblock pre > code, .listingblock pre[class] > code { display: block; }
-.listingblock > .content { position: relative; }
-.listingblock:hover code[class*=" language-"]:before { text-transform: uppercase; font-size: 0.9em; color: #999; position: absolute; top: 0.375em; right: 0.375em; }
-.listingblock:hover code.asciidoc:before { content: "asciidoc"; }
-.listingblock:hover code.clojure:before { content: "clojure"; }
-.listingblock:hover code.css:before { content: "css"; }
-.listingblock:hover code.go:before { content: "go"; }
-.listingblock:hover code.groovy:before { content: "groovy"; }
-.listingblock:hover code.html:before { content: "html"; }
-.listingblock:hover code.java:before { content: "java"; }
-.listingblock:hover code.javascript:before { content: "javascript"; }
-.listingblock:hover code.python:before { content: "python"; }
-.listingblock:hover code.ruby:before { content: "ruby"; }
-.listingblock:hover code.sass:before { content: "sass"; }
-.listingblock:hover code.scss:before { content: "scss"; }
-.listingblock:hover code.xml:before { content: "xml"; }
-.listingblock:hover code.yaml:before { content: "yaml"; }
-.listingblock.terminal pre .command:before { content: attr(data-prompt); padding-right: 0.5em; color: #999; }
-.listingblock.terminal pre .command:not([data-prompt]):before { content: '$'; }
-table.pyhltable { border: 0; margin-bottom: 0; }
-table.pyhltable td { vertical-align: top; padding-top: 0; padding-bottom: 0; }
-table.pyhltable td.code { padding-left: .75em; padding-right: 0; }
-.highlight.pygments .lineno, table.pyhltable td:not(.code) { color: #999; padding-left: 0; padding-right: .5em; border-right: 1px solid #d8d8d8; }
-.highlight.pygments .lineno { display: inline-block; margin-right: .25em; }
-table.pyhltable .linenodiv { background-color: transparent !important; padding-right: 0 !important; }
-.quoteblock { margin: 0 0 1.25em 0; padding: 0.5625em 1.25em 0 1.1875em; border-left: 3px solid #487c58; }
-.quoteblock blockquote { margin: 0 0 1.25em 0; padding: 0 0 0.625em 0; border: 0; }
-.quoteblock blockquote > .paragraph:last-child p { margin-bottom: 0; }
-.quoteblock .attribution { margin-top: -0.625em; padding-bottom: 0.625em; font-size: inherit; color: #454545; line-height: 1.6; }
-.quoteblock .attribution br { display: none; }
-.quoteblock .attribution cite { display: block; }
-table.tableblock { max-width: 100%; }
-table.tableblock td .paragraph:last-child p > p:last-child, table.tableblock th > p:last-child, table.tableblock td > p:last-child { margin-bottom: 0; }
-table.spread { width: 100%; }
-table.tableblock, th.tableblock, td.tableblock { border: 0 solid #dddddd; }
-table.grid-all th.tableblock, table.grid-all td.tableblock { border-width: 0 1px 1px 0; }
-table.grid-all tfoot > tr > th.tableblock, table.grid-all tfoot > tr > td.tableblock { border-width: 1px 1px 0 0; }
-table.grid-cols th.tableblock, table.grid-cols td.tableblock { border-width: 0 1px 0 0; }
-table.grid-all * > tr > .tableblock:last-child, table.grid-cols * > tr > .tableblock:last-child { border-right-width: 0; }
-table.grid-rows th.tableblock, table.grid-rows td.tableblock { border-width: 0 0 1px 0; }
-table.grid-all tbody > tr:last-child > th.tableblock, table.grid-all tbody > tr:last-child > td.tableblock, table.grid-all thead:last-child > tr > th.tableblock, table.grid-rows tbody > tr:last-child > th.tableblock, table.grid-rows tbody > tr:last-child > td.tableblock, table.grid-rows thead:last-child > tr > th.tableblock { border-bottom-width: 0; }
-table.grid-rows tfoot > tr > th.tableblock, table.grid-rows tfoot > tr > td.tableblock { border-width: 1px 0 0 0; }
-table.frame-all { border-width: 1px; }
-table.frame-sides { border-width: 0 1px; }
-table.frame-topbot { border-width: 1px 0; }
-th.halign-left, td.halign-left { text-align: left; }
-th.halign-right, td.halign-right { text-align: right; }
-th.halign-center, td.halign-center { text-align: center; }
-th.valign-top, td.valign-top { vertical-align: top; }
-th.valign-bottom, td.valign-bottom { vertical-align: bottom; }
-th.valign-middle, td.valign-middle { vertical-align: middle; }
-table thead th, table tfoot th { font-weight: bold; }
-tbody tr th { display: table-cell; line-height: 1.6; background: whitesmoke; }
-tbody tr th, tbody tr th p, tfoot tr th, tfoot tr th p { color: #333333; font-weight: bold; }
-td > div.verse { white-space: pre; }
-ul.unstyled, ol.unnumbered, ul.checklist, ul.none { list-style-type: none; }
-ul.unstyled, ol.unnumbered, ul.checklist { margin-left: 0.625em; }
-ul.checklist li > p:first-child > .fa-check-square-o:first-child, ul.checklist li > p:first-child > input[type="checkbox"]:first-child { margin-right: 0.25em; }
-ul.checklist li > p:first-child > input[type="checkbox"]:first-child { position: relative; top: 1px; }
-ul.inline { margin: 0 auto 0.625em auto; margin-left: -1.375em; margin-right: 0; padding: 0; list-style: none; overflow: hidden; }
-ul.inline > li { list-style: none; float: left; margin-left: 1.375em; display: block; }
-ul.inline > li > * { display: block; }
-.unstyled dl dt { font-weight: normal; font-style: normal; }
-ol.arabic { list-style-type: decimal; }
-ol.decimal { list-style-type: decimal-leading-zero; }
-ol.loweralpha { list-style-type: lower-alpha; }
-ol.upperalpha { list-style-type: upper-alpha; }
-ol.lowerroman { list-style-type: lower-roman; }
-ol.upperroman { list-style-type: upper-roman; }
-ol.lowergreek { list-style-type: lower-greek; }
-.hdlist > table, .colist > table { border: 0; background: none; }
-.hdlist > table > tbody > tr, .colist > table > tbody > tr { background: none; }
-td.hdlist1 { padding-right: .75em; font-weight: bold; }
-td.hdlist1, td.hdlist2 { vertical-align: top; }
-.literalblock + .colist, .listingblock + .colist { margin-top: -0.5em; }
-.colist > table tr > td:first-of-type { padding: 0 .75em; line-height: 1; }
-.colist > table tr > td:last-of-type { padding: 0.25em 0; }
-.qanda > ol > li > p > em:only-child { color: #1d4b8f; }
-.thumb, .th { line-height: 0; display: inline-block; border: solid 4px white; -webkit-box-shadow: 0 0 0 1px #dddddd; box-shadow: 0 0 0 1px #dddddd; }
-.imageblock.left, .imageblock[style*="float: left"] { margin: 0.25em 0.625em 1.25em 0; }
-.imageblock.right, .imageblock[style*="float: right"] { margin: 0.25em 0 1.25em 0.625em; }
-.imageblock > .title { margin-bottom: 0; }
-.imageblock.thumb, .imageblock.th { border-width: 6px; }
-.imageblock.thumb > .title, .imageblock.th > .title { padding: 0 0.125em; }
-.image.left, .image.right { margin-top: 0.25em; margin-bottom: 0.25em; display: inline-block; line-height: 0; }
-.image.left { margin-right: 0.625em; }
-.image.right { margin-left: 0.625em; }
-a.image { text-decoration: none; }
-span.footnote, span.footnoteref { vertical-align: super; font-size: 0.875em; }
-span.footnote a, span.footnoteref a { text-decoration: none; }
-span.footnote a:active, span.footnoteref a:active { text-decoration: underline; }
-#footnotes { padding-top: 0.75em; padding-bottom: 0.75em; margin-bottom: 0.625em; }
-#footnotes hr { width: 20%; min-width: 6.25em; margin: -.25em 0 .75em 0; border-width: 1px 0 0 0; }
-#footnotes .footnote { padding: 0 0.375em; line-height: 1.3; font-size: 0.875em; margin-left: 1.2em; text-indent: -1.2em; margin-bottom: .2em; }
-#footnotes .footnote a:first-of-type { font-weight: bold; text-decoration: none; }
-#footnotes .footnote:last-of-type { margin-bottom: 0; }
-#content #footnotes { margin-top: -0.625em; margin-bottom: 0; padding: 0.75em 0; }
-.gist .file-data > table { border: none; background: #fff; width: 100%; margin-bottom: 0; }
-.gist .file-data > table td.line-data { width: 99%; }
-div.unbreakable { page-break-inside: avoid; }
-.replaceable { font-style: italic; font-color: inherit; font-family: inherit; }
-.parameter { font-style: italic; font-family: monospace; }
-.userinput { font-weight: bold; font-family: monospace; }
-.envar { font-weight: bold; font-family: monospace; font-size: 90%; }
-.sysitem { font-weight: bold; font-size: 90%; }
-.package { font-weight: bold; font-size: 90%; }
-.filename { font-weight: bold; font-style: italic; font-size: 90%; }
-.big { font-size: larger; }
-.small { font-size: smaller; }
-.underline { text-decoration: underline; }
-.overline { text-decoration: overline; }
-.line-through { text-decoration: line-through; }
-.aqua { color: #00bfbf; }
-.aqua-background { background-color: #00fafa; }
-.black { color: black; }
-.black-background { background-color: black; }
-.blue { color: #0000bf; }
-.blue-background { background-color: #0000fa; }
-.fuchsia { color: #bf00bf; }
-.fuchsia-background { background-color: #fa00fa; }
-.gray { color: #606060; }
-.gray-background { background-color: #7d7d7d; }
-.green { color: #006000; }
-.green-background { background-color: #007d00; }
-.lime { color: #00bf00; }
-.lime-background { background-color: #00fa00; }
-.maroon { color: #600000; }
-.maroon-background { background-color: #7d0000; }
-.navy { color: #000060; }
-.navy-background { background-color: #00007d; }
-.olive { color: #606000; }
-.olive-background { background-color: #7d7d00; }
-.purple { color: #600060; }
-.purple-background { background-color: #7d007d; }
-.red { color: #bf0000; }
-.red-background { background-color: #fa0000; }
-.silver { color: #909090; }
-.silver-background { background-color: #bcbcbc; }
-.teal { color: #006060; }
-.teal-background { background-color: #007d7d; }
-.white { color: #bfbfbf; }
-.white-background { background-color: #fafafa; }
-.yellow { color: #bfbf00; }
-.yellow-background { background-color: #fafa00; }
-span.icon > .fa { cursor: default; }
-.admonitionblock td.icon [class^="fa icon-"] { font-size: 2.5em; cursor: default; }
-.admonitionblock td.icon .icon-note:before { content: "\f05a"; color: #4E9FDD; }
-.admonitionblock td.icon .icon-tip:before { content: "\f0eb"; color: #2C8596; }
-.admonitionblock td.icon .icon-warning:before { content: "\f071"; color: #ec7a08; }
-.admonitionblock td.icon .icon-caution:before { content: "\f06d"; color: #ec7a08; }
-.admonitionblock td.icon .icon-important:before { content: "\f06a"; color: #c00; }
-.conum[data-value] { display: inline-block; color: white !important; background-color: #333333; -webkit-border-radius: 100px; border-radius: 100px; text-align: center; width: 20px; height: 20px; font-size: 12px; line-height: 20px; font-family: "Open Sans", "Sans", sans-serif; font-style: normal; font-weight: bold; text-indent: -1px; }
-.conum[data-value] * { color: white !important; }
-.conum[data-value] + b { display: none; }
-.conum[data-value]:after { content: attr(data-value); }
-pre .conum[data-value] { position: relative; top: -2px; }
-b.conum * { color: inherit !important; }
-.conum:not([data-value]):empty { display: none; }
-.print-only { display: none !important; }
-@media print { @page { margin: 1.25cm 0.75cm; }
-  * { -webkit-box-shadow: none !important; box-shadow: none !important; text-shadow: none !important; }
-  a, a:visited { color: inherit !important; text-decoration: underline !important; }
-  a[href^="http:"]:after, a[href^="https:"]:after { content: " (" attr(href) ")"; }
-  a[href^="#"], a[href^="#"]:visited, a[href^="mailto:"], a[href^="mailto:"]:visited { text-decoration: none !important; }
-  abbr[title]:after { content: " (" attr(title) ")"; }
-  pre, blockquote { page-break-inside: avoid; }
-  code { color: #191919; }
-  thead { display: table-header-group; }
-  tr, img { page-break-inside: avoid; }
-  img { max-width: 100% !important; }
-  p { orphans: 3; widows: 3; }
-  h2, h3, #toctitle, .sidebarblock > .content > .title, #toctitle, .sidebarblock > .content > .title { page-break-after: avoid; }
-  #toc, .sidebarblock { background: none !important; }
-  #toc { border-bottom: 1px solid #d8d8d8 !important; padding-bottom: 0 !important; }
-  .sect1 { padding-bottom: 0 !important; }
-  .sect1 + .sect1 { border: none !important; }
-  body.book #header { text-align: center; }
-  body.book #header > h1 { border: none !important; margin: 2.5em 0 1em 0; padding: 0; }
-  body.book #header span { line-height: 1.6; }
-  body.book #header br { display: block; }
-  body.book #header br + span { padding-left: 0; }
-  body.book #header br + span:before { content: none !important; }
-  body.book #toc { border: none !important; text-align: left !important; padding: 0 !important; }
-  #footer { background: none !important; }
-  #footer-text { color: #333333 !important; }
-  .hide-on-print { display: none !important; }
-  .print-only { display: block !important; }
-  .hide-for-print { display: none !important; }
-  .show-for-print { display: inherit !important; } }
--- a/_templates/_css.html.erb
+++ b/_templates/_css.html.erb
@ -1,3 +0,0 @@
-<%- Dir.glob("_stylesheets/*").sort.each do |sheet| -%>
-  <link href="<%= File.join(css_path, File.basename(sheet)) %>" rel="stylesheet" />
-<%- end -%>
--- a/_templates/_footer.html.erb
+++ b/_templates/_footer.html.erb
@ -1,88 +0,0 @@
-    <div id="bottom" class="text-muted py-3" >
-        <div class="foot">
-            <div class="container">
-                <div class="row footerlinks">
-                    <div class="col-sm-3 col-xs-6 widget">
-                        <h3 class="widget-title">About</h3>
-                        <div class="widget-body">
-                            <dl>
-                                <dd><a href="https://fedoraproject.org/wiki/Overview">About Fedora</a></dd>
-                                <dd><a href="https://getfedora.org/en/sponsors">Sponsors</a></dd>
-                                <dd><a href="https://fedoramagazine.org">Fedora Magazine</a></dd>
-				<dd><a href="https:https://fedoraproject.org/wiki/Legal:Main#Legal">Legal</a></dd>
-                            </dl>
-                            <ul class="list-inline">
-                            <li>
-                                <a href="https:https://www.facebook.com/TheFedoraProject" class="btn-social btn-outline"><i class="fa fa-fw fa-facebook"></i></a>
-                            </li>
-                            <li>
-                                <a href="https:https://plus.google.com/112917221531140868607" class="btn-social btn-outline"><i class="fa fa-fw fa-google-plus"></i></a>
-                            </li>
-                            <li>
-                                <a href="https:https://twitter.com/fedora" class="btn-social btn-outline"><i class="fa fa-fw fa-twitter"></i></a>
-                            </li>
-                        </ul>
-                        </div>
-                    </div>
-
-                    <div class="col-sm-3 col-xs-6 widget">
-                        <h3 class="widget-title uppercase">Download</h3>
-                        <div class="widget-body">
-                          <dl>
-                            <dd><a href="https://getfedora.org/en/workstation/download">Get Fedora Workstation</a></dd>
-                            <dd><a href="https://getfedora.org/en/server/download">Get Fedora Server</a></dd>
-                            <dd><a href="https://getfedora.org/en/atomic/download">Get Fedora Atomic</a></dd>
-                            <dd><a href="https://spins.fedoraproject.org">Fedora Spins</a></dd>
-                            <dd><a href="https://labs.fedoraproject.org">Fedora Labs</a></dd>
-                            <dd><a href="https://arm.fedoraproject.org">Fedora ARM<span class="sup">&reg;</span></a></dd>
-                            <dd><a href="https://alt.fedoraproject.org/">Alternative Downloads</a></dd>
-
-                        </dl>
-                        </div>
-                    </div>
-
-                    <div class="col-sm-3 col-xs-6 widget">
-                        <h3 class="widget-title">Support</h3>
-                        <div class="widget-body">
-                            <dl>
-                                <dd><a href="https://fedoraproject.org/wiki/Communicating_and_getting_help">Get Help</a></dd>
-                                <dd><a href="https://ask.fedoraproject.org/">Ask Fedora</a></dd>
-                                <dd><a href="https://fedoraproject.org/wiki/Common_F${global_variables.release['curr_id']}_bugs">Common Bugs</a></dd>
-                                <dd><a href="https://developer.fedoraproject.org/">Fedora Developer Portal</a></dd>
-                                <dd><a href="https://docs.fedoraproject.org/en-US/Fedora/${global_variables.release['curr_id']}/html/Installation_Guide">Installation Guide</a></dd>
-                            </dl>
-                        </div>
-                    </div>
-
-                    <div class="col-sm-3 col-xs-6 widget">
-                        <h3 class="widget-title">Join</h3>
-                        <div class="widget-body">
-                            <dl>
-                                <dd><a href="https://fedoraproject.org/wiki/Join">Join Fedora</a></dd>
-                                <dd><a href="http://fedoraplanet.org">Planet Fedora</a></dd>
-                                <dd><a href="https://fedoraproject.org/wiki/SIGs">Fedora SIGs</a></dd>
-                                <dd><a href="https://admin.fedoraproject.org/accounts/">Fedora Account System</a></dd>
-                                <dd><a href="http://fedoracommunity.org/">Fedora Community</a></dd>
-                            </dl>
-                        </div>
-                    </div>
-                </div> <!-- /row of widgets -->
-
-                <div class="row">
-                    <div class="col-md-2">
-                        <div class="widget-body">
-                            <a href="http://www.redhat.com/"><img class="rh-logo" src="../_images/redhat-logo.png" alt="Red Hat Logo" /></a>
-                        </div>
-                    </div>
-                    <div class="col-md-7">
-                        <div class="widget-body">
-                            <p class="sponsor">Fedora is sponsored by Red Hat.</p>
-                            <p class="sponsor"><a href="https://www.redhat.com/en/technologies/linux-platforms/articles/relationship-between-fedora-and-rhel">Learn more about the relationship between Red Hat and Fedora &raquo;</a></p>
-                            <p class="copy">&copy; 2017 Red Hat, Inc. and others. Please send any comments or corrections to the <a href="https://fedorahosted.org/fedora-websites/">websites team</a></p>
-                        </div>
-                    </div>
-                </div> <!-- /row of widgets -->
-
-            </div>
-        </div>
-    </div>
--- a/_templates/_nav.html.erb
+++ b/_templates/_nav.html.erb
@ -1,31 +0,0 @@
-<ul class="nav nav-sidebar">
-  <%- navigation.each.with_index do |topic_group, groupidx| -%>
-    <%- current_group = topic_group[:id] == group_id -%>
-    <li class="nav-header">
-      <a class="" href="#" data-toggle="collapse" data-target="#topicGroup<%= groupidx %>">
-        <span id="tgSpan<%= groupidx %>" class="fa <%= current_group ? 'fa-angle-down' : 'fa-angle-right' %>"></span><%= topic_group[:name] %>
-      </a>
-      <ul id="topicGroup<%= groupidx %>" class="collapse <%= current_group ? 'in' : '' %> list-unstyled">
-        <%- topic_group[:topics].each.with_index do |topic, topicidx| -%>
-          <%- if not topic.has_key?(:topics) -%>
-            <%- current_topic = current_group && (topic[:id] == topic_id) -%>
-            <li><a class="<%= current_topic ? ' active' : '' %>" href="<%= subtopic_shim %><%= topic[:path] %>"><%= topic[:name] %></a></li>
-          <%- else -%>
-            <%- current_subgroup = topic[:id] == subgroup_id -%>
-            <li class="nav-header">
-              <a class="" href="#" data-toggle="collapse" data-target="#topicSubGroup-<%= groupidx %>-<%= topicidx %>">
-                <span id="sgSpan-<%= groupidx %>-<%= topicidx %>" class="fa <%= current_subgroup ? 'fa-caret-down' : 'fa-caret-right' %>"></span>&nbsp;<%= topic[:name] %>
-              </a>
-              <ul id="topicSubGroup-<%= groupidx %>-<%= topicidx %>" class="nav-tertiary list-unstyled collapse<%= current_subgroup ? ' in' : '' %>">
-                <%- topic[:topics].each do |subtopic| -%>
-                  <%- current_subtopic = current_group && current_subgroup && (subtopic[:id] == topic_id) %>
-                  <li><a class="<%= current_subtopic ? ' active' : '' %>" href="<%= subtopic_shim %><%= subtopic[:path] %>"><%= subtopic[:name] %></a></li>
-                <%- end -%>
-              </ul>
-            </li>
-          <%- end -%>
-        <%- end -%>
-      </ul>
-    </li>
-  <%- end -%>
-</ul>
--- a/_templates/page.html.erb
+++ b/_templates/page.html.erb
@ -1,181 +0,0 @@
-<!DOCTYPE html>
-<html>
-<head>
-  <meta charset="utf-8">
-  <meta content="IE=edge" http-equiv="X-UA-Compatible">
-  <meta content="width=device-width, initial-scale=1.0" name="viewport">
-  <title><%= distro %> <%= version %> | <%= [group_title, subgroup_title, topic_title].compact.join(' | ') %></title>
-
-  <!-- Bootstrap -->
-  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
-  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap-theme.min.css">
-
-  <%= render("_templates/_css.html.erb", :css_path => css_path) %>
-
-   <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
-   <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
-   <!--[if lt IE 9]>
-     <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
-     <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
-   <![endif]-->
-
-  <link href="<%= File.join(images_path, "favicon32x32.png") %>" rel="shortcut icon" type="text/css">
-  <!--[if IE]><link rel="shortcut icon" href="<%= File.join(images_path, "favicon.ico") %>"><![endif]-->
-  <meta content="AsciiBinder" name="application-name">
-</head>
-<body>
-  <div class="navbar navbar-default" role="navigation">
-    <div class="container-fluid">
-      <div class="navbar-header">
-        <a class="navbar-brand" href="https://docs.fedoraproject.org/"><img alt="Fedora Documentation" src="<%= File.join(images_path, "fedora.svg") %>"></a>
-      </div>
-    </div>
-  </div>
-  <div class="container">
-    <p class="toggle-nav visible-xs pull-left">
-      <button class="btn btn-default btn-sm" type="button" data-toggle="offcanvas">Toggle nav</button>
-    </p>
-    <ol class="breadcrumb">
-      <li class="sitename">
-        <a href="<%= site_home_path %>"><%= site_name %></a>
-      </li>
-      <li class="hidden-xs active">
-        <%= breadcrumb_root %>
-      </li>
-      <li class="hidden-xs active">
-        <%= breadcrumb_group %>
-      </li>
-      <%= breadcrumb_subgroup_block %>
-      <li class="hidden-xs active">
-        <%= breadcrumb_topic %>
-      </li>
-    </ol>
-    <div class="row row-offcanvas row-offcanvas-left">
-      <div class="col-xs-8 col-sm-3 col-md-3 sidebar sidebar-offcanvas">
-        <%= render("_templates/_nav.html.erb", :navigation => navigation, :group_id => group_id, :topic_id => topic_id, :subgroup_id => subgroup_id, :subtopic_shim => subtopic_shim) %>
-      </div>
-      <div class="col-xs-12 col-sm-9 col-md-9 main">
-        <div class="page-header">
-          <h2><%= article_title %></h2>
-        </div>
-        <%= content %>
-      </div>
-    </div>
-  </div>
-  <div id="bottom" class="text-muted py-3" >
-      <div class="foot">
-          <div class="container">
-              <div class="row footerlinks">
-                  <div class="col-sm-3 col-xs-6 widget">
-                      <h3 class="widget-title">About</h3>
-                      <div class="widget-body">
-                          <dl>
-                              <dd><a href="https://fedoraproject.org/wiki/Overview">About Fedora</a></dd>
-                              <dd><a href="https://getfedora.org/en/sponsors">Sponsors</a></dd>
-                              <dd><a href="https://fedoramagazine.org">Fedora Magazine</a></dd>
-		<dd><a href="https:https://fedoraproject.org/wiki/Legal:Main#Legal">Legal</a></dd>
-                          </dl>
-                          <ul class="list-inline">
-                          <li>
-                              <a href="https:https://www.facebook.com/TheFedoraProject" class="btn-social btn-outline"><i class="fa fa-fw fa-facebook"></i></a>
-                          </li>
-                          <li>
-                              <a href="https:https://plus.google.com/112917221531140868607" class="btn-social btn-outline"><i class="fa fa-fw fa-google-plus"></i></a>
-                          </li>
-                          <li>
-                              <a href="https:https://twitter.com/fedora" class="btn-social btn-outline"><i class="fa fa-fw fa-twitter"></i></a>
-                          </li>
-                      </ul>
-                      </div>
-                  </div>
-
-                  <div class="col-sm-3 col-xs-6 widget">
-                      <h3 class="widget-title uppercase">Download</h3>
-                      <div class="widget-body">
-                        <dl>
-                          <dd><a href="https://getfedora.org/en/workstation/download">Get Fedora Workstation</a></dd>
-                          <dd><a href="https://getfedora.org/en/server/download">Get Fedora Server</a></dd>
-                          <dd><a href="https://getfedora.org/en/atomic/download">Get Fedora Atomic</a></dd>
-                          <dd><a href="https://spins.fedoraproject.org">Fedora Spins</a></dd>
-                          <dd><a href="https://labs.fedoraproject.org">Fedora Labs</a></dd>
-                          <dd><a href="https://arm.fedoraproject.org">Fedora ARM<span class="sup">&reg;</span></a></dd>
-                          <dd><a href="https://alt.fedoraproject.org/">Alternative Downloads</a></dd>
-
-                      </dl>
-                      </div>
-                  </div>
-
-                  <div class="col-sm-3 col-xs-6 widget">
-                      <h3 class="widget-title">Support</h3>
-                      <div class="widget-body">
-                          <dl>
-                              <dd><a href="https://fedoraproject.org/wiki/Communicating_and_getting_help">Get Help</a></dd>
-                              <dd><a href="https://ask.fedoraproject.org/">Ask Fedora</a></dd>
-                              <dd><a href="https://fedoraproject.org/wiki/Common_F${global_variables.release['curr_id']}_bugs">Common Bugs</a></dd>
-                              <dd><a href="https://developer.fedoraproject.org/">Fedora Developer Portal</a></dd>
-                              <dd><a href="https://docs.fedoraproject.org/en-US/Fedora/${global_variables.release['curr_id']}/html/Installation_Guide">Installation Guide</a></dd>
-                          </dl>
-                      </div>
-                  </div>
-
-                  <div class="col-sm-3 col-xs-6 widget">
-                      <h3 class="widget-title">Join</h3>
-                      <div class="widget-body">
-                          <dl>
-                              <dd><a href="https://fedoraproject.org/wiki/Join">Join Fedora</a></dd>
-                              <dd><a href="http://fedoraplanet.org">Planet Fedora</a></dd>
-                              <dd><a href="https://fedoraproject.org/wiki/SIGs">Fedora SIGs</a></dd>
-                              <dd><a href="https://admin.fedoraproject.org/accounts/">Fedora Account System</a></dd>
-                              <dd><a href="http://fedoracommunity.org/">Fedora Community</a></dd>
-                          </dl>
-                      </div>
-                  </div>
-              </div> <!-- /row of widgets -->
-
-              <div class="row">
-                  <div class="col-md-2">
-                      <div class="widget-body">
-                          <a href="http://www.redhat.com/"><img class="rh-logo" src="<%= File.join(images_path, "redhat-logo.png") %>" alt="Red Hat Logo" /></a>
-                      </div>
-                  </div>
-                  <div class="col-md-7">
-                      <div class="widget-body">
-                          <p class="sponsor">Fedora is sponsored by Red Hat.</p>
-                          <p class="sponsor"><a href="https://www.redhat.com/en/technologies/linux-platforms/articles/relationship-between-fedora-and-rhel">Learn more about the relationship between Red Hat and Fedora &raquo;</a></p>
-                          <p class="copy">&copy; 2017 Red Hat, Inc. and others. Please send any comments or corrections to the <a href="https://fedorahosted.org/fedora-websites/">websites team</a></p>
-                      </div>
-                  </div>
-              </div> <!-- /row of widgets -->
-
-          </div>
-      </div>
-  </div>
-   <!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
-   <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
-   <!-- Latest compiled and minified JavaScript -->
-   <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
-   <script src="<%= File.join(javascripts_path, "bootstrap-offcanvas.js") %>" type="text/javascript"></script>
-   <script type="text/javascript">
-    /*<![CDATA[*/
-    $(document).ready(function() {
-      $("[id^='topicGroup']").on('show.bs.collapse', function (event) {
-        if (!($(event.target).attr('id').match(/^topicSubGroup/))) {
-          $(this).parent().find("[id^='tgSpan']").toggleClass("fa-angle-right fa-angle-down");
-        }
-      });
-      $("[id^='topicGroup']").on('hide.bs.collapse', function (event) {
-        if (!($(event.target).attr('id').match(/^topicSubGroup/))) {
-          $(this).parent().find("[id^='tgSpan']").toggleClass("fa-angle-right fa-angle-down");
-        }
-      });
-      $("[id^='topicSubGroup']").on('show.bs.collapse', function () {
-        $(this).parent().find("[id^='sgSpan']").toggleClass("fa-caret-right fa-caret-down");
-      });
-      $("[id^='topicSubGroup']").on('hide.bs.collapse', function () {
-        $(this).parent().find("[id^='sgSpan']").toggleClass("fa-caret-right fa-caret-down");
-      });
-    });
-    /*]]>*/
-  </script>
-</body>
-</html>
--- a/_topic_map.yml
+++ b/_topic_map.yml
@ -1,88 +0,0 @@
-# This configuration file dictates the organization of the topic groups and
-# topics on the main page of the doc site for this branch. Each record
-# consists of the following:
-#
-# ---                                  <= Record delimiter
-# Name:  Origin of the Species          <= Display name of topic group
-# Dir:  origin_of_the_species          <= Directory name of topic group
-# Topics:
-#   - Name:  The Majestic Marmoset      <= Topic name
-#     File:  the_majestic_marmoset      <= Topic file under group dir +/-
-#   - Name:  The Curious Crocodile      <= Topic 2 name
-#     File:  the_curious_crocodile      <= Topic 2 file
-#   - Name:  The Numerous Nematodes     <= Sub-topic group name
-#     Dir: the_numerous_nematodes      <= Sub-topic group dir
-#     Topics:
-#       - Name:  The Wily Worm          <= Sub-topic name
-#         File:  the_wily_worm          <= Sub-topic file under <group dir>/<subtopic dir>
-#       - Name:  The Acrobatic Ascarid  <= Sub-topic 2 name
-#         File:  the_acrobatic_ascarid  <= Sub-topic 2 file under <group dir>/<subtopic dir>
-#
-# The ordering of the records in this document determines the ordering of the
-# topic groups and topics on the main page.
---
-Name:  Fedora Release Notes
-Dir: en-US
-Topics:
-  - Name: Book Information
-    File: index
-  - Name: Welcome to Fedora
-    Dir: welcome
-    Topics:
-      - Name: Welcome to Fedora
-        File: Welcome
-      - Name: Overview
-        File: Overview
-      - Name: Hardware Overview
-        File: Hardware_Overview
-      - Name: Feedback
-        File: Feedback
-  - Name: Changes in Fedora for System Administrators
-    Dir: sysadmin
-    Topics:
-      - Name: Fedora Modularity
-        File: Modularity
-      - Name: Kernel
-        File: Kernel
-      - Name: Installation
-        File: Installation
-      - Name: Security
-        File: Security
-      - Name: Mail Servers
-        File: Mail_Servers
-      - Name: X.Org
-        File: Xorg
-  - Name: Changes in Fedora for Desktop Users
-    Dir: desktop
-    Topics:
-      - Name: Desktop
-        File: Desktop
-      - Name: Networking
-        File: Networking
-      - Name: Internationalization
-        File: I18n
-  - Name: Changes in Fedora for Developers
-    Dir: developers
-    Topics:
-      - Name: Development Tools
-        File: Development_Tools
-      - Name: C
-        File: Development_C
-      - Name: Containers
-        File: Containers
-      - Name: Boost
-        File: Development_Boost
-      - Name: D
-        File: Development_D
-      - Name: Go
-        File: Development_Go
-      - Name: Haskell
-        File: Development_Haskell
-      - Name: Python
-        File: Development_Python
-      - Name: Ruby
-        File: Development_Ruby
-      - Name: Web Development
-        File: Development_Web
-  - Name: Revision History
-    File: Revision_History
--- a/antora.yml
+++ b/antora.yml
@ -0,0 +1,3 @@
+---
+name: fedora
+version: f27
--- a/build.sh
+++ b/build.sh
@ -0,0 +1,51 @@
+#!/bin/bash
+
+image="docker.io/antora/antora"
+cmd="--html-url-extension-style=indexify site.yml"
+
+if uname | grep -iwq darwin; then
+    # Running on macOS.
+    # Let's assume that the user has the Docker CE installed
+    # which doesn't require a root password.
+    echo ""
+    echo "This build script is using Docker to run the build in an isolated environment."
+    echo ""
+    docker run --rm -it -v $(pwd):/antora ${image} ${cmd}
+
+elif uname | grep -iq linux; then
+    # Running on Linux.
+    # Let's assume that it's running the Docker deamon
+    # which requires root.
+
+    if [ -f /usr/local/bin/antora ]; then
+        /usr/local/bin/antora ${cmd}
+    elif uname -m | grep -iwq aarch64; then
+        echo "No antora/aarch64 container try just \`npm install -g @antora/cli @antora/site-generator-default\`"
+    elif [ -f /usr/bin/podman ]; then
+        echo ""
+        echo "This build script is using Podman to run the build in an isolated environment."
+        echo ""
+        podman run --rm -it -v $(pwd):/antora:z ${image} ${cmd}
+
+    elif [ -f /usr/bin/docker ]; then
+        echo ""
+        echo "This build script is using Docker to run the build in an isolated environment."
+        echo ""
+
+        if groups | grep -wq "docker"; then
+            docker run --rm -it -v $(pwd):/antora:z ${image} ${cmd}
+        else
+            echo "You might be asked for your password."
+            echo "You can avoid this by adding your user to the 'docker' group,"
+            echo "but be aware of the security implications."
+            echo "See https://docs.docker.com/install/linux/linux-postinstall/"
+            echo ""
+            sudo docker run --rm -it -v $(pwd):/antora:z ${image} ${cmd}
+        fi
+    else
+        echo ""
+        echo "Error: Container runtime has not been found on your system. Fix it by running this command:"
+        echo "sudo dnf install podman"
+        exit 1
+    fi
+fi
--- a/en-US/desktop/Desktop.adoc
+++ b/en-US/desktop/Desktop.adoc
@ -1,32 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-desktop]]
-== Desktop
-
-[[sect-desktop-gnome3.24]]
-=== GNOME 3.24: Portland
-
-The GNOME 3 desktop environment has been upgraded to GNOME 3.24. This new version includes a number of major new features and enhancements, as well as many smaller improvements and bug fixes:
-
-* Night Light is a new feature that subtly changes the screen color according to the time of day, which can help to reduce sleeplessness if you use your computer at night.
-
-* Weather information is now included in the notifications area to show a simple summary of the day’s weather, and links to the Weather application.
-
-* Other GNOME applications that have been improved for 3.24 include Web, Photos, Polari, Games, Calendar and the Calculator.
-
-More detailed information about GNOME 3.24 can be found in the link:++https://help.gnome.org/misc/release-notes/3.24/++[release notes].
-
-[[sect-desktop-lxqt-spin]]
-=== New Spin: LXQt Desktop
-
-Fedora LXQt provides a lightweight, well-integrated LXQt desktop environment. In addition to LXQt itself, it provides a small, well selected collection of applications, such as the [application]*QupZilla* browser, which combines the rendering engine frtom [application]*Chromium* with a nice Qt experience. As all applications use the same Qt5 toolkit and the Breeze theme known from KDE, the desktop provides a unified and well-integrated style and theming. In addition, [package]*breeze-gtk* is provided to allow the user to integrate GTK applications too.
-
-The LXQt Desktop spin is available for download from link:++http://spins.fedoraproject.org/++[http://spins.fedoraproject.org/].
-
-To contact other LXQt users and maintainers of the LXQt spin, connect to the `#fedora-lxqt` IRC channel on irc.freenode.net or send an email to the LXQt List at link:++https://admin.fedoraproject.org/mailman/listinfo/users++[users@lists.fedoraproject.org].
-
-[[sect-desktop-fontconfig-cache]]
-=== Fontconfig Cache Moved to /usr
-
-Prior to this update, the [package]*fontconfig* cache files were placed in the `/var/cache/fontconfig` directory. This location was incompatible with the `OStree` model used by Fedora Atomic, which prevented using the same package for Atomic and other Fedora variants. To fix this incompatibility, the cache files have been moved to `/usr/lib/fontconfig/cache`.
--- a/en-US/desktop/I18n.adoc
+++ b/en-US/desktop/I18n.adoc
@ -1,10 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-i18n]]
-== Internationalization
-
-[[sect-i18n-pinyin]]
-=== libpinyin 2.0
-
-libpinyin 2.0 helps Chinese Pinyin users to increase their input speed by needing fewer key presses. ibus-libpinyin with libpinyin 2.0 provides 1-3 sentence candidates and improves the dictionary. Also the libpinyin license has changed to GPLv3+.
--- a/en-US/desktop/Networking.adoc
+++ b/en-US/desktop/Networking.adoc
@ -1,19 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-networking]]
-== Networking
-
-[[sect-networking-openvpn]]
-=== OpenVPN Rebased to Version 2.4.3
-
-[application]*OpenVPN* has been rebased to version 2.4.3. This update adds many improvements, notably improved elliptic curve cryptography support (`ECDH`), support for `AES-GCM`, and additional encryption layer of the control channel (the [option]`--tls-crypt` option), and a type of cipher negotiation which allows for gradually upgrading client ciphers to stronger ones without significant added complexity. Additionally, there is now a seamless client IP and port available, allowing clients to change their IP address or port without having to fully renegotiate an established tunnel.
-
-For a full list of changes in this version, see the link:++https://github.com/OpenVPN/openvpn/blob/v2.4.3/Changes.rst++[upstream changelog on GitHub].
-
-Overall integration with [application]*systemd* has also improved, and systemd can now better manage OpenVPN processes. This update ships with brand new systemd unit files, which add additional security hardening. These new unit files are preferred over the old `openvpn@.service` file. The same unit files are used in other Linux distributions which use systemd, ensuring a more consistent behavior and usage between different systemd-based systems. See installed documentation in `/usr/share/doc/openvpn/README.systemd` for more information about this topic.
-
-.Additional Notes
-In other changes, Certificate Revocation List (`CRL`) checking is now done by [command]`SSL` libraries directly. These libraries have a far more strict acceptance policy than the approach previously used in OpenVPN. For example, if your CRL file has expired, this will have an impact on every user, regardless of whether their certificates are revoked or not.
-
-Additionally, OpenVPN in Fedora 26 currently use the [package]*compat-openssl10* and [package]*compat-openssl10-pkcs11-helper* compatibility packages, which are considered to be a workaround until more thorough testing can be done on OpenSSL 1.1, which has only been introduced in OpenVPN recently. In a later update, the OpenVPN package is expected to be upgraded to make use of the newer [package]*openssl-1.1* library.
--- a/en-US/developers/Containers.adoc
+++ b/en-US/developers/Containers.adoc
@ -1,22 +0,0 @@
-[[sect-containers]]
-
-include::en-US/entities.adoc[]
-
-== Containers
-
-[[overlay2-for-docker]]
-=== OverlayFS is now default for Docker
-
-The default storage option for Docker is now OverlayFS via the Overlay2 driver, which provides better performance. Overlay2 provides performance advantages in memory sharing compared to devicemapper. Additionally, support for SELinux for the Overlay file systems have been added.
-
-[NOTE]
-===
-Overlay is not a POSIX-compliant file system and there could be problems with running containers on Overlay. Therefore, you can easily switch back to devicemapper in these cases. For more information about switching storage options, check the documentation for the [command]`atomic storage` commands.
-===
-
-Upgraded systems will not be affected.
-
-[[docker-sdk-for-python-version-2]]
-=== Docker SDK for Python, version 2
-
-A new version of Docker SDK for Python, the Python library which communicates with the Docker engine API, has been added to Fedora 26. It provides a new, high-level, user-focused API provided as `docker.DockerClient`. This obsoletes the existing [package]*python-docker-py* package. The functionality is now provided by the [package]*python2-docker* and [package]*python3-docker* packages. The `docker.Client` class has been renamed to `docker.APIClient`. Note that the version 2 of Docker SDK is not backwards compatible with the versions earlier than 1.10.6 of the library.
--- a/en-US/developers/Development_Boost.adoc
+++ b/en-US/developers/Development_Boost.adoc
@ -1,12 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-boost]]
-== Boost
-
-[[sect-boost-boost163]]
-=== Boost 1.63
-
-Boost has been upgraded to version 1.63. Apart from a number of bugfixes and improvements to existing libraries, this brings six new libraries compared to Fedora 25: Boost.Compute, Boost.DLL, Boost.Hana, Boost.Metaparse, Boost.Fiber and Boost.QVM.
-
-For more information, see the link:++http://www.boost.org/users/history/version_1_63_0.html++[Boost 1.63 Release Notes].
--- a/en-US/developers/Development_C.adoc
+++ b/en-US/developers/Development_C.adoc
@ -1,33 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-c]]
-== C
-
-[[sect-gcc-gcc7]]
-=== GNU Compiler Collection (GCC) Rebased to 7.1
-
-The [application]*GNU Compiler Collection (GCC)* has been rebased to version 7.1, a major new release that provides a number of new features as well as many improvements and bugfixes. In addition to offering the new GCC to developers, Fedora packages have been recompiled using the new version. See link:++http://gcc.gnu.org/gcc-7/changes.html++[Changes, New Features, and Fixes in the GCC 7 Release Series].
-
-Developers should see link:++https://gcc.gnu.org/gcc-7/porting_to.html++[Porting to GCC 7] for detailed information on how to update their codebases to work with the new compilers.
-
-[[sect-c-glibc-2-25]]
-=== The GNU C Library Version 2.25
-
-The GNU C Library in Fedora 26 has been rebased to version 2.25, which brings many improvements and bug fixes over the previous version. Notable changes include:
-
-* Additional support for floating-point extensions for C (TS 18661-1:2014) including new functions like `strfromd`, `strfromf`, and `strfroml`.
-
-* The function `explicit_bzero`, from OpenBSD, has been added to `libc`. It is intended to be used instead of `memset()` to erase sensitive data after use.
-
-* The `getentropy` and `getrandom` functions, and the `<sys/random.h>` header file, have been added.
-
-* GDB pretty printers have been added for `mutex` and `condition` variable structures in POSIX Threads.
-
-* Tunables feature added to allow tweaking of the runtime for an application program.
-
-* New improved algorithms for condition variables and read-write locks for POSIX Threads.
-
-* Security fixes for link:++https://nvd.nist.gov/vuln/detail/CVE-2016-6323++[CVE-2016-6323], and link:++https://nvd.nist.gov/vuln/detail/CVE-2015-5180++[CVE-2015-5180].
-
-Detailed release are available as part of the link:++https://sourceware.org/ml/libc-alpha/2017-02/msg00079.html++[upstream release notice].
--- a/en-US/developers/Development_D.adoc
+++ b/en-US/developers/Development_D.adoc
@ -1,10 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-d]]
-== D
-
-[[sect-d-ldc]]
-=== LLVM-based D Compiler (LDC) v1.1.0
-
-The LDC D compiler has been updated to version 1.1.0. More information about this release is contained in the link:++https://github.com/ldc-developers/ldc/releases/tag/v1.1.0++[LDC 1.1.0 release note].
--- a/en-US/developers/Development_Go.adoc
+++ b/en-US/developers/Development_Go.adoc
@ -1,17 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-development-go]]
-== Go
-
-[[sect-development-golang]]
-=== Golang 1.8
-
-The latest Go release, version 1.8, brings changes to the implementation of the toolchain, runtime, and libraries. There are also two minor changes to the language specification. This release maintains the Go v1 promise of compatibility and so the Go Project expects almost all Go programs to continue to compile and run as before.
-
-More detail can be found in the link:++https://tip.golang.org/doc/go1.8++[Go 1.8 Release Notes].
-
-[[sect-development-golang-pie]]
-=== Golang Buildmode PIE
-
-Fedora 26 changes the default build mode for golang in Fedora packaging macros to `buildmode=pie`, which results in the production of _Position Independent Executables_. Also, the Fedora hardned linker flags are passed to the external linker, reducing the vulnerability of the generated binaries.
--- a/en-US/developers/Development_Haskell.adoc
+++ b/en-US/developers/Development_Haskell.adoc
@ -1,12 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-haskell]]
-== Haskell
-
-[[sect-development-ghc80]]
-=== Glasgow Haskell Complier v8.0
-
-The Glasgow Haskell Compiler (GHC) has been upgraded from version 7.10 to version 8.0.2, all Haskell packages in Fedora have been rebuilt and many have been updated. This GHC release brings much improved support for aarch64, ppc64, and ppc64le as well as many new features, fixes, and improvements.
-
-More information about the new features in GHC version 8 can be found in the release notes for versions link:++https://downloads.haskell.org/~ghc/8.0.2/docs/html/users_guide/8.0.1-notes.html++[8.0.1] and link:++https://downloads.haskell.org/~ghc/8.0.2/docs/html/users_guide/8.0.2-notes.html++[8.0.2].
--- a/en-US/developers/Development_Python.adoc
+++ b/en-US/developers/Development_Python.adoc
@ -1,42 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-python]]
-== Python
-
-[[sect-python-3-6]]
-=== Python 3.6
-
-Python 3.6 will be the default Python 3 stack in Fedora 26. This is an upgrade from 3.5 which was included in Fedora 25. All packages which depend on Python 3 must be rebuilt. User-written Python 3 scripts and applications may require a small amount of porting; however, Python 3.5 is forward compatible with Python 3.6 for the most part.
-
-Notable new features include:
-
-* Formatted string literals (f-strings): `f"This will be evaluated to foo's value: {foo}"`
-
-* The order of elements in `+**kwargs: keyword+` arguments now preserve their order
-
-* The new `secrets` module provides handy helpers for secure token generation in various formats
-
-* Underscores in numeric literals let you break up magic constants to make them easier to read: `1_000_000`
-
-* File system path protocol: Many more standard library APIs, including the builtin `open()`, now support `pathlib.Path` and `pathlib.PurePath` objects
-
-* A range of performance improvements.
-
-For more detailed information see the link:++https://fedoramagazine.org/python-3-6-0-fedora-26/++[Fedora Magazine announcement article] or the link:++https://docs.python.org/3.6/whatsnew/3.6.html++[upstream release notes]. Note the link:++https://docs.python.org/3.6/whatsnew/3.6.html#porting-to-python-3-6++[Porting to Python 3.6] section, which lists important information for developers who need to port their Python 3.5 applications.
-
-[[sect-python-classrom]]
-=== Python Classroom Lab
-
-Fedora 26 brings in a new Python Classroom Lab. A variant of Fedora targeted at teachers and students of the Python programming langugae. A ready to use environment with Python, PyPy 3, virtualenv, tox, git, Jupyter Notebook and more. It's ready in three variants: as a GNOME powered desktop or headless for Vagrant and Docker.
-
-Find out more about the Python Classroom Lab on the link:++https://labs.fedoraproject.org/en/python-classroom/++[Fedora Labs] website.
-
-[[sect-python-cutf8-locale]]
-=== Python 3 C.UTF-8 locale
-
-An ongoing challenge within the Python 3 series has been determining a sensible default strategy for handling the “7-bit ASCII” text encoding assumption currently implied by the use of the default C locale.
-
-Starting with Fedora 26, the Fedora system Python includes a backport of Python 3.7's upcoming link:++https://docs.python.org/dev/whatsnew/3.7.html#pep-538-legacy-c-locale-coercion++[locale coercion] feature, which means the Python 3 stack will automatically coerce the C locale to C.UTF-8 by setting the `LC_CTYPE` environment variable (if neither it nor `LC_ALL` are already set) before configuring the process locale. Automatically setting `LC_CTYPE` this way means that both the core interpreter and locale-aware C extensions (such as `readline`) will assume the use of UTF-8 as the default text encoding, rather than ASCII.
-
-Full details of this new Python feature are contained in link:++https://www.python.org/dev/peps/pep-0538/++[PEP 538 -- Coercing the legacy C locale to a UTF-8 based local].
--- a/en-US/developers/Development_Ruby.adoc
+++ b/en-US/developers/Development_Ruby.adoc
@ -1,22 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-ruby]]
-== Ruby
-
-[[sect-ruby-ruby24]]
-=== Ruby 2.4
-
-Ruby 2.4 is the latest stable version of Ruby. Many new features and improvements are included, for example:
-
-* hash table improvements
-
-* unify Fixnum and Bignum into Integer
-
-* String supports Unicode case mappings
-
-* performance and debugging improvements
-
-Ruby 2.4 includes updates to soname and so Ruby packages that use binary extensions should be rebuilt. Nevertheless, since the Ruby community paid great attention to source compatibility, no changes to your code are needed.
-
-More information about Ruby 2.4 can be found in the Ruby community's link:++https://www.ruby-lang.org/en/news/2016/12/25/ruby-2-4-0-released/++[ Ruby 2.4.0 Release Notes].
--- a/en-US/developers/Development_Tools.adoc
+++ b/en-US/developers/Development_Tools.adoc
@ -1,17 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-development-tools]]
-== Development Tools
-
-[[sect-pkgconf]]
-=== pkgconf as System pkg-config Implementation
-
-In Fedora 26, the pkg-config implementation has been switched to pkgconf. This is a newer, actively-maintained implementation of pkg-config that offers more advanced support for `.pc` files and provides a library interface for developers to integrate pkg-config processing into their applications.
-
-More information about pkgconf can be found at link:++http://pkgconf.org/++[pkgconf.org].
-
-[[sect-development-tools-coredumpctl]]
-=== Enable systemd-coredump by Default
-
-By default, core dumps from crashing programs are now stored by systemd-coredump, rather than created in the crashing process's current working directory by ABRT. They may be extracted using the `coredumpctl` tool. For example, simply run `coredumpctl{nbsp}gdb` to view a backtrace for the most recent crash in gdb. For more information on this change, refer to the manpages `coredumpctl(1)`, `systemd-coredump(8)`, and `coredump.conf(5)`.
--- a/en-US/developers/Development_Web.adoc
+++ b/en-US/developers/Development_Web.adoc
@ -1,21 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-web-development]]
-== Web Development
-
-[[webdev_php]]
-=== PHP 7.1
-
-The popular web development language PHP has been upgraded from 7.0 to 7.1 for Fedora 26. Pacakges providing extensions to PHP have been rebuilt to use the new release; developers using extensions from non-packaged sources should update them. While most common PHP applications should be able to use the new release without issue, impacted developers should review the links below for information provided by upstream PHP about the upgrade.
-
-* link:++http://php.net/manual/en/migration71.php++[Migrating from PHP 7.0.x to PHP 7.1.x]
-
-* link:++https://raw.githubusercontent.com/php/php-src/PHP-7.1/UPGRADING++[PHP 7.1 UPGRADE NOTES]
-
-* link:++https://raw.githubusercontent.com/php/php-src/PHP-7.1/UPGRADING.INTERNALS++[PHP 7.1 INTERNALS UPGRADE NOTES]
-
-[[webdev_zend]]
-=== Zend Framework 3.0
-
-Fedora 26 offers the latest version 3 of the popular PHP framework, `Zend`. Zend 3 offers increased performance, support for PHP 7, improved link:++https://docs.zendframework.com/++[project documentation], and more. For detailed information, refer to the upstream release announcement at link:++https://framework.zend.com/blog/2016-06-28-zend-framework-3.html++[Zend Framework 3 Released!] or their link:++https://docs.zendframework.com/tutorials/migration/to-v3/overview/++[migration guides].
--- a/en-US/index.adoc
+++ b/en-US/index.adoc
@ -1,16 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-== Release Notes
-
-Release Notes for Fedora {PRODVER}
-
-[abstract]
--
-This document provides the release notes for Fedora {PRODVER}. It describes major changes offered as compared to Fedora {PREVVER}.
--
-
-image:../../Common_Content/images/title_logo.svg[Fedora Logo]
-include::Common_Content/Legal_Notice.adoc[]
-
-include::en-US/Author_Group.adoc[]
--- a/en-US/sysadmin/Installation.adoc
+++ b/en-US/sysadmin/Installation.adoc
@ -1,80 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-installation]]
-== Installation
-
-[[sect-installation-anaconda]]
-=== Anaconda Changes
-
-This section covers changes in the [application]*Anaconda* installer, including changes in the graphical and text mode interactive installers, Kickstart, and installer boot options.
-
-[[sect-installation-anaconda-gui]]
-==== Changes in the Graphical Interface
-
-* A new, alternate partitioning interface provided by the the [application]*blivet-gui* tool is now available in the manual partitioning screen. Unlike the existing partitioning interface, [application]*blivet-gui* allows you to configure partitioning from the "bottom up": for example, in case of LVM you first create physical volumes, then a volume group, and then logical volumes, while in the old interface, you start with logical volumes and everything else is created automatically at first.
-+
-The previous partitioning interface continues to be available as alongside the new one. For additional information, see the link:++https://fedoraproject.org/wiki/Changes/AnacondaBlivetGUI++[Fedora Project Wiki].
-
-* The installer now shows more detailed indication of current progress during all phases of the installation.
-
-[[sect-installation-anaconda-tui]]
-==== Changes in the Text Mode Interface
-
-* The text mode interface now supports setting up IP over Inifiniband IPoIB connections in the Networking screen.
-
-* The built-in help system, which was previously available in the graphical installation interface, has been extended to the text mode interface.
-
-* The [application]*Initial Setup* post-setup text mode interface now runs on all available consoles.
-
-[[sect-installation-kickstart]]
-==== Kickstart Changes
-
-* A new command, [command]`snapshot`, has been added to provide LVM snapshot support for devices in an LVM thin pool. The command has the following syntax:
-+
-[subs="macros"]
----
-snapshot pass:quotes[_vg/lv_] --name pass:quotes[_snapshot_name_] --when [post-install|pre-install]
----
-+
-Available options are:
-
-** [option]`--name=` - provide a name for the snapshot.
-
-** [option]`--when=` - controls when the snapshot will be created. Use `pre-install` to create the snapshot before the installation begins, but after commands in the [command]`%pre` part of the Kickstart are executed, or use `post-install` to create the snapshot after the installation and after commands in the [command]`%post` part of the Kickstart are executed.
-
-* Three new options are now available for the [command]`autopart` command:
-
-** [option]`--nohome` - do not create a separate `/home` partition or volume if one would be created under partitioning rules
-
-** [option]`--noboot` - do not create a separate `/boot` partition or volume
-
-** [option]`--noswap` - do not create any swap space
-
-[[sect-installation-anaconda-boot-options]]
-==== Changes in Anaconda Boot Options
-
-* The [option]`inst.waitfornet=` boot option is now available. Use it to force the installer to wait for network connectivity before starting the installer interface for a specified number of seconds - for example, [option]`inst.waitfornet=30` to wait 30 seconds.
-
-* A new option named [option]`inst.ksstrict` is available. You can use it during a Kickstart-based installation to treat Kickstart warnings and error, meaning they will be printed on the output and the installation will terminate. Without specifying this option, warnings are printed to the log and the installation proceeds.
-
-[[sect-installation-anaconda-other]]
-==== Other Anaconda Changes
-
-* Driver Update Disks can now be loaded from local disk devices.
-
-* `Installclass` can now modify rules for storage checks and their constraints.
-
-[[sect-installation-fmw]]
-=== ARM Support in Fedora Media Writer
-
-Fedora Media Writer has gained the ability to write ARM images to SD cards and other portable media. Users, including those on Windows and macOS as well as on Fedora, will now be able to write Fedora images easily for Raspberry Pi 2 and above and for other supported ARM devices. Please note that this applies only for ARM devices where there are no changes or tweaks that need to be done to the Fedora image.
-
-More information about this latest release of Fedora Media Writer can be found in the link:++https://github.com/MartinBriza/MediaWriter/releases/tag/4.1.0++[FMW 4.1.0 Release Notes].
-
-[[sect-installation-dnf-20]]
-=== DNF Rebased to 2.0
-
-[application]*DNF*, Fedora's package manager, has been rebased to version 2.0, which brings many bugfixes and improvements over [application]*DNF 1.x*, as well as changes required to fix incompatibilities with [application]*Yum*, the predecessor of DNF. This required the introduction of certain incompatibilities between DNF 2.0 and DNF 1.x. See link:++http://dnf.readthedocs.io/en/latest/dnf-1_vs_dnf-2.html++[Changes in DNF-2 compared to DNF-1] for details.
-
-DNF 2.0 provides usability improvements, including better messages during resolution errors, showing whether a package was installed as a weak dependency, better handling of obsolete packages, fewer tracebacks, and others.
--- a/en-US/sysadmin/Kernel.adoc
+++ b/en-US/sysadmin/Kernel.adoc
@ -1,14 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-kernel]]
-== Kernel
-
-[[sect-kernel-aarch64-48bitva]]
-=== aarch64 48-bit Virtual Address Space
-
-Before Fedora 26, the aarch64 kernel in Fedora used a 42-bit process virtual address (VA) space and due to the way aarch64 paging works, this constrained the maximum physical address as well. The 42-bit VA was fairly limiting for some applications, but aarch64 processors also have support for 48-bit VAs.
-
-For Fedora 26, Fedora has introduced a 48-bit VA and so larger aarch64 processes won't be constrained by the virtual or physical limitations of a 42-bit VA. This change also helps with things like hugetlb's and potentially provides a performace boost. Additionally, it allows Fedora to boot on a class of machines that have the majority of their RAM higher in the address space.
-
-Its unlikely a desktop user will notice the change, except possibly that Fedora might now boot on additional hardware. A server user might find that there is more RAM available for in-memory databases etc.
--- a/en-US/sysadmin/Mail_Servers.adoc
+++ b/en-US/sysadmin/Mail_Servers.adoc
@ -1,16 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-mail-servers]]
-== Mail Servers
-
-[[sect-mail-servers-cyrus-imapd]]
-=== Cyrus IMAP Server Upgraded to Version 3
-
-In Fedora 26, the [application]*Cyrus IMAP server* (`cyrus-imapd`) has been upgraded to version 3. This version brings significant new functionality, but it also has some new internal database formats. It has also changed the defaults for some important configuration settings. For these reasons it is important that you read and follow link:++https://cyrusimap.org/imap/download/upgrade.html#shut-down-existing-cyrus++[upstream's upgrade documentation] before you initiate an update to Fedora 26.
-
-Important changes to note:
-
-* Cyrus version 3 has changed the defaults for two important configuration options: `unixhierarchysep` and `altnamespace`. You may need to add them with their previously default value of `0` if these are not present in your existing configuration.
-
-* Cyrus version 3 no longer supports the `berkeley` database type. If you have essential databases in that format, it is important that you convert them to a different format before you update your system. However, if you have already updated, don't panic. The default Fedora configuration does use this format, but only for non-essential databases which you will rebuild while following the update documentation linked above.
--- a/en-US/sysadmin/Modularity.adoc
+++ b/en-US/sysadmin/Modularity.adoc
@ -1,20 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-modularity]]
-== Fedora Modularity
-
-Fedora Modularity is attempting to disconnect the lifecycles of applications from each other and also from that of the operating system, while still maintaining the ease of use of a typical Linux distribution. More information about this work is available in the link:++https://docs.pagure.org/modularity/++[Fedora Modularity documentation].
-
-[[sect-modularity-server-preview]]
-=== Modular Server Preview
-
-Fedora 26 contains a "preview" release of a modular Fedora Server Edition.
-
-.Not for production use
-[IMPORTANT]
-===
-The Fedora 26 Modular Server Preview is a working version of the Server Edition but it is still a prototype and so it should not be used in a production environment.
-===
-
-The purpose of this preview release is to request feedback from the user community. The Modularity Working Group would like to hear from anyone experimenting with the preview about how it does or does not meet their expectations. Contact details for the Modularity Working Group are on the link:++https://docs.pagure.org/modularity/++[Fedora Modularity home page].
--- a/en-US/sysadmin/Security.adoc
+++ b/en-US/sysadmin/Security.adoc
@ -1,56 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-security]]
-== Security
-
-[[security-crypto]]
-=== System-wide Crypto Policy
-
-The security of network communications is a high priority for the Fedora project, with strong TLS providing the first line of defense against traffic inspection. Two systems negotiating a TLS connection must agree on a common cipher to encrypt their communications, and as ciphers become deprecated, it is important to exclude them.
-
-The ciphers that an administrator might consider adequately secure are determined by vulnerabilities published against specific ciphers. The acceptable cipher suite applies to all communications on the internet, and is not specific to any one system or daemon. To ease administration and increase adminsitrator confidence in the system's security posture, Fedora has been configuring various software to use a system-global configuration so that TLS ciphers need only be updated in one place.
-
-With Fedora 26, two more things will use the system-wide crypto policy, `OpenSSH` and `Java`.
-
-.OpenSSH Crypto
-OpenSSH clients will use system preferred key exchange algorithms, encryption ciphers, and message authentication code (MAC) algorithms. This is enabled by an `Include` directive in `/etc/ssh/ssh_config` to include directives in `/etc/ssh/ssh_config.d/*.conf`, which pulls in `/etc/crypto-policies/back-ends/openssh.config`.
-
-.Java Crypto
-OpenJDK has been modified to read additional security properties from the generated crypto policies file at `/etc/crypto-policies/back-ends/java.config`
-
-This change may affect connections to legacy systems that do not support more strict crypto policies. While it is possible to switch the system profile from DEFAULT to LEGACY, or to set `security.useSystemPropertiesFile=false` in a project's `java.security` file (refer to link:++https://docs.oracle.com/javase/8/docs/technotes/guides/security/PolicyFiles.html++[]), it would be best to also update legacy applications to modern security standards.
-
-[[sect-security-openssl110]]
-=== OpenSSL 1.1.0
-
-The introduction of OpenSSL 1.1.0 in Fedora 26 brings many big improvements, new cryptographic algorithms, and API changes that allow for keeping the ABI stable in future upgrades. There is also now a compat-openssl10 package in Fedora that provides OpenSSL 1.0.2 for dependent applications that cannot move to 1.1.0 yet.
-
-There is more information about OpenSSL 1.1.0 in the link:++https://wiki.openssl.org/index.php/OpenSSL_1.1.0_Changes++[ OpenSSL wiki].
-
-[[sect-security-opensc]]
-=== OpenSC Replaces Coolkey
-
-Fedora 26 is not shipping the Coolkey PKCS#11 module in the NSS database by default. Instead, there will be the OpenSC PKCS#11 module, which supports more different Smart Cards. The Coolkey package will be removed in Fedora 27. If other applications were using Coolkey, they should be able to switch to OpenSC.
-
-In case you still need Coolkey in the NSS DB, you can add it manually using [command]`modutil -dbdir /etc/pki/nssdb -add "CoolKey PKCS #11 Module (manual)" -libfile libcoolkeypk11.so -force` (the different name is used to prevent automatic removals when updating coolkey package).
-
-Soon (during F26 cycle) there will be fully-featured 0.17.0 update to OpenSC with all the tested features and cards that should serve as a complete replacement of Coolkey.
-
-[[sect-security-sssd]]
-=== SSSD fast cache for local users
-
-SSSD has shipped with a very fast memory cache in the last couple of Fedora releases. However, using this cache conflicts with nscd's caching and nscd has been disabled by default. That degrades performance, because every user or group lookup must open the local files.
-
-From Fedora 26, a new SSSD "files" provider will resolve users from the local files. That way, the "sss" NSS module can be configured before the files module in nsswitch.conf and the system can leverage sss_nss caching for both local and remote users. As a result, user and group resolution in Fedora will be much faster.
-
-[[sect-security-authconfig-cleanup]]
-=== Authconfig cleanup
-
-Obsolete and unmaintainable code was removed from [command]`authconfig`. Notably:
-
-* The graphical interface ([package]*system-config-authentication*) and the interactive text mode, which relied on old and unmaintained libraries (GTK+2 and Glade) have been removed from the distribution.
-
-* The command line tool, which has been deprecated previously, continues to be part of the distribution for legacy reasons. However, some deprecated and obsolete functionality such as support for `WINS` and `HESIOD` has been removed in this release.
-
-The removal effort is happening because current modern environments support automatic configuration of remote user identities using `Realmd` and `SSSD` and do not require manual configuration through an interactive interface such as [package]*system-config-authentication*. Some of the existing authconfig command line functionality is being preserved due to it still retaining some usefulness in certain environments, and to support the [command]`auth` command in Kickstart. Removing parts of the code base that are no longer maintainable makes it easier to continue providing this functionality.
--- a/en-US/sysadmin/Xorg.adoc
+++ b/en-US/sysadmin/Xorg.adoc
@ -1,20 +0,0 @@
-
-include::en-US/entities.adoc[]
-
-[[sect-x-org]]
-== X.Org
-
-[[sect-x-org-synaptics]]
-=== Retire Synaptics Driver
-
-[package]*xorg-x11-drv-synaptics* has been the main X.Org touchpad driver for over a decade. Since Fedora 22, it has been superseded by [package]*xorg-x11-drv-libinput* which aims to provide a better touchpad experience.
-
-Starting with Fedora 26:
-
-* a fresh installation of Fedora will install [package]*xorg-x11-drv-libinput* instead of [package]*xorg-x11-drv-synaptics*;
-
-* an upgrade from an earlier Fedora will install [package]*xorg-x11-drv-libinput* and remove [package]*xorg-x11-drv-synaptics*;
-
-* users that need the synaptics driver will need to manually install [package]*xorg-x11-drv-synaptics-legacy*, which will install the synaptics driver and give it precedence over the *libinput* driver;
-
-* removing [package]*xorg-x11-drv-synaptics-legacy* will remove the synaptics driver and the system will automatically revert to the *libinput* driver.
--- a/index-main.html
+++ b/index-main.html
@ -1,141 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-  <head>
-    <meta charset="utf-8">
-    <meta http-equiv="X-UA-Compatible" content="IE=edge">
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags -->
-
-    <title>Fedora Documentation Website</title>
-
-    <!-- Bootstrap -->
-    <link rel="stylesheet" href="_stylesheets/asciibinder.css">
-    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
-    <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap-theme.min.css">
-
-    <!-- HTML5 shim and Respond.js for IE8 support of HTML5 elements and media queries -->
-    <!-- WARNING: Respond.js doesn't work if you view the page via file:// -->
-    <!--[if lt IE 9]>
-      <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
-      <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
-    <![endif]-->
-  </head>
-  <body>
-    <div class="container">
-      <div class="row">
-        <div class="page-header">
-          <img src="_images/fedora.svg" class="img-responsive" />
-        </div>
-      </div>
-      <div class="row">
-        <div class="col-md-8">
-          <h4><strong>Fedora Documentation Site</strong></h4>
-          <p>Test Build.</p>
-        </div>
-        <div class="col-md-4">
-          <h5><strong>Fedora Documentation</strong></h5>
-          <div class="list-group">
-            <a href="f26/en-US/index.html" class="list-group-item">
-              &nbsp;Fedora 26 Documentation
-            </a>
-            <a href="rawhide/en-US/index.html" class="list-group-item">
-              &nbsp;Rawhide Documentation
-            </a>
-          </div>
-        </div>
-      </div>
-    </div>
-    <div id="bottom" class="text-muted py-3" >
-        <div class="foot">
-            <div class="container">
-                <div class="row footerlinks">
-                    <div class="col-sm-3 col-xs-6 widget">
-                        <h3 class="widget-title">About</h3>
-                        <div class="widget-body">
-                            <dl>
-                                <dd><a href="https://fedoraproject.org/wiki/Overview">About Fedora</a></dd>
-                                <dd><a href="https://getfedora.org/en/sponsors">Sponsors</a></dd>
-                                <dd><a href="https://fedoramagazine.org">Fedora Magazine</a></dd>
-				<dd><a href="https:https://fedoraproject.org/wiki/Legal:Main#Legal">Legal</a></dd>
-                            </dl>
-                            <ul class="list-inline">
-                            <li>
-                                <a href="https:https://www.facebook.com/TheFedoraProject" class="btn-social btn-outline"><i class="fa fa-fw fa-facebook"></i></a>
-                            </li>
-                            <li>
-                                <a href="https:https://plus.google.com/112917221531140868607" class="btn-social btn-outline"><i class="fa fa-fw fa-google-plus"></i></a>
-                            </li>
-                            <li>
-                                <a href="https:https://twitter.com/fedora" class="btn-social btn-outline"><i class="fa fa-fw fa-twitter"></i></a>
-                            </li>
-                        </ul>
-                        </div>
-                    </div>
-
-                    <div class="col-sm-3 col-xs-6 widget">
-                        <h3 class="widget-title uppercase">Download</h3>
-                        <div class="widget-body">
-                          <dl>
-                            <dd><a href="https://getfedora.org/en/workstation/download">Get Fedora Workstation</a></dd>
-                            <dd><a href="https://getfedora.org/en/server/download">Get Fedora Server</a></dd>
-                            <dd><a href="https://getfedora.org/en/atomic/download">Get Fedora Atomic</a></dd>
-                            <dd><a href="https://spins.fedoraproject.org">Fedora Spins</a></dd>
-                            <dd><a href="https://labs.fedoraproject.org">Fedora Labs</a></dd>
-                            <dd><a href="https://arm.fedoraproject.org">Fedora ARM<span class="sup">&reg;</span></a></dd>
-                            <dd><a href="https://alt.fedoraproject.org/">Alternative Downloads</a></dd>
-
-                        </dl>
-                        </div>
-                    </div>
-
-                    <div class="col-sm-3 col-xs-6 widget">
-                        <h3 class="widget-title">Support</h3>
-                        <div class="widget-body">
-                            <dl>
-                                <dd><a href="https://fedoraproject.org/wiki/Communicating_and_getting_help">Get Help</a></dd>
-                                <dd><a href="https://ask.fedoraproject.org/">Ask Fedora</a></dd>
-                                <dd><a href="https://fedoraproject.org/wiki/Common_F${global_variables.release['curr_id']}_bugs">Common Bugs</a></dd>
-                                <dd><a href="https://developer.fedoraproject.org/">Fedora Developer Portal</a></dd>
-                                <dd><a href="https://docs.fedoraproject.org/en-US/Fedora/${global_variables.release['curr_id']}/html/Release_Notes">Release Notes</a></dd>
-                            </dl>
-                        </div>
-                    </div>
-
-                    <div class="col-sm-3 col-xs-6 widget">
-                        <h3 class="widget-title">Join</h3>
-                        <div class="widget-body">
-                            <dl>
-                                <dd><a href="https://fedoraproject.org/wiki/Join">Join Fedora</a></dd>
-                                <dd><a href="http://fedoraplanet.org">Planet Fedora</a></dd>
-                                <dd><a href="https://fedoraproject.org/wiki/SIGs">Fedora SIGs</a></dd>
-                                <dd><a href="https://admin.fedoraproject.org/accounts/">Fedora Account System</a></dd>
-                                <dd><a href="http://fedoracommunity.org/">Fedora Community</a></dd>
-                            </dl>
-                        </div>
-                    </div>
-                </div> <!-- /row of widgets -->
-
-                <div class="row">
-                    <div class="col-md-2">
-                        <div class="widget-body">
-                            <a href="http://www.redhat.com/"><img class="rh-logo" src="_images/redhat-logo.png" alt="Red Hat Logo" /></a>
-                        </div>
-                    </div>
-                    <div class="col-md-7">
-                        <div class="widget-body">
-                            <p class="sponsor">Fedora is sponsored by Red Hat.</p>
-                            <p class="sponsor"><a href="https://www.redhat.com/en/technologies/linux-platforms/articles/relationship-between-fedora-and-rhel">Learn more about the relationship between Red Hat and Fedora &raquo;</a></p>
-                            <p class="copy">&copy; 2017 Red Hat, Inc. and others. Please send any comments or corrections to the <a href="https://fedorahosted.org/fedora-websites/">websites team</a></p>
-                        </div>
-                    </div>
-                </div> <!-- /row of widgets -->
-
-            </div>
-        </div>
-    </div>
-    <!-- jQuery (necessary for Bootstrap's JavaScript plugins) -->
-    <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
-    <!-- Include all compiled plugins (below), or include individual files as needed -->
-    <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/js/bootstrap.min.js"></script>
-  </body>
-</html>
--- a/modules/release-notes/assets/images/title_logo.svg
+++ b/modules/release-notes/assets/images/title_logo.svg
--- a/modules/release-notes/nav.adoc
+++ b/modules/release-notes/nav.adoc
@ -0,0 +1,23 @@
+* xref:index.adoc[Fedora Release Notes]
+** xref:welcome/Welcome.adoc[Welcome to Fedora]
+*** xref:welcome/Overview.adoc[Overview]
+*** xref:welcome/Hardware_Overview.adoc[Hardware Overview]
+*** xref:welcome/Feedback.adoc[Feedback]
+** Changes in Fedora for System Administrators
+*** xref:sysadmin/Modularity.adoc[Fedora Modularity]
+*** xref:sysadmin/Installation.adoc[Installation]
+*** xref:sysadmin/Security.adoc[Security]
+*** xref:sysadmin/Domain_Controllers.adoc[Domain Controllers]
+*** xref:sysadmin/ARM_Architectures.adoc[ARM Architectures]
+*** xref:sysadmin/Packaging.adoc[Packaging]
+** Changes in Fedora for Desktop Users
+*** xref:desktop/Desktop.adoc[Desktop]
+** Changes in Fedora for Developers
+*** xref:developers/Development_Tools.adoc[Development Tools]
+*** xref:developers/Development_C.adoc[C and C++]
+*** xref:developers/Development_Go.adoc[Go]
+*** xref:developers/Development_Java.adoc[Java]
+*** xref:developers/Development_Perl.adoc[Perl]
+*** xref:developers/Development_Python.adoc[Python]
+*** xref:developers/Development_Ruby.adoc[Ruby]
+*** xref:developers/Development_Web.adoc[Web Development]
--- a/modules/release-notes/pages/Revision_History.adoc
+++ b/modules/release-notes/pages/Revision_History.adoc
@ -1,8 +1,6 @@
-
-include::en-US/entities.adoc[]
-
 [[appe-Release_Notes-Revision_History]]
-== Revision History
+= Revision History
+include::{partialsdir}/entities.adoc[]

 `26.01-3`:: Sun Jul 30 2017, (docs AT lists.fedoraproject.org), First AsciiDoc version.

--- a/modules/release-notes/pages/_partials/Author_Group.adoc
+++ b/modules/release-notes/pages/_partials/Author_Group.adoc
--- a/modules/release-notes/pages/_partials/Feedback.adoc
+++ b/modules/release-notes/pages/_partials/Feedback.adoc
--- a/modules/release-notes/pages/_partials/Legal_Notice.adoc
+++ b/modules/release-notes/pages/_partials/Legal_Notice.adoc
--- a/modules/release-notes/pages/_partials/entities.adoc
+++ b/modules/release-notes/pages/_partials/entities.adoc
@ -4,8 +4,8 @@
 :COMMONBUGS_URL: http://fedoraproject.org/wiki/Common_F26_bugs
 :HOLDER: Fedora Project Contributors
 :KERNEL: 4.8
-:NEXTVER: 27
+:NEXTVER: 28
 :PREVVER: 26
 :PRODUCT: Fedora Documentation
-:PRODVER: Rawhide
+:PRODVER: 27
 :YEAR: 2017
--- a/modules/release-notes/pages/desktop/Desktop.adoc
+++ b/modules/release-notes/pages/desktop/Desktop.adoc
@ -0,0 +1,7 @@
+[[sect-desktop]]
+= Desktop
+include::{partialsdir}/entities.adoc[]
+
+[[sect-desktop-dnfdragora]]
+== dnfdragora replaces Yumex-DNF
+Previous releases of Fedora have included https://github.com/timlau/yumex-dnf/blob/develop/README.md[Yumex-DNF] as a graphical user interface for package management.  Yumex-DNF is no longer under active development and so it has been replaced in Fedora 27 by https://github.com/manatools/dnfdragora[dnfdragora]. dnfdragora is a new DNF frontend that is written in Python 3 and uses https://github.com/libyui/libyui[libYui], the widget abstraction library written by SUSE, so that it can be run using Qt 5, GTK+ 3, or ncurses interfaces.
--- a/modules/release-notes/pages/desktop/I18n.adoc
+++ b/modules/release-notes/pages/desktop/I18n.adoc
@ -0,0 +1,3 @@
+[[sect-i18n]]
+= Internationalization
+include::{partialsdir}/entities.adoc[]
--- a/modules/release-notes/pages/desktop/Networking.adoc
+++ b/modules/release-notes/pages/desktop/Networking.adoc
@ -0,0 +1,3 @@
+[[sect-networking]]
+= Networking
+include::{partialsdir}/entities.adoc[]
--- a/modules/release-notes/pages/developers/Containers.adoc
+++ b/modules/release-notes/pages/developers/Containers.adoc
@ -0,0 +1,4 @@
+
+[[sect-containers]]
+= Containers
+include::{partialsdir}/entities.adoc[]
--- a/modules/release-notes/pages/developers/Development_C.adoc
+++ b/modules/release-notes/pages/developers/Development_C.adoc
@ -0,0 +1,20 @@
+[[sect-c]]
+= C and C++
+include::{partialsdir}/entities.adoc[]
+
+[[sect-boost]]
+== Boost 1.64
+The http://www.boost.org[Boost C++ libraries] have been upgraded to version 1.64. Apart from a number of bugfixes and improvements to existing libraries, this brings a new library compared to Fedora 26, Boost.Process.
+For more information, see the http://www.boost.org/users/history/version_1_64_0.html[Boost 1.64 release notes].
+
+[[sect-c-glibc]]
+== GNU C Library 2.26
+Fedora 27 ships with version 2.26 of the GNU C Library (glibc). New features include:
+
+* A per-thread malloc cache has been added that significantly improves the malloc API family of functions on certain multithreaded workloads.
+* Unicode 10.0.0 support for character encodings, character type info, and transliteration tables.
+* Improvements in the DNS stub resolver including runtime detection of changed DNS servers (/etc/resolv.conf changes) and use of those new servers without needing to restart the process.
+
+Security improvements include fixes for the  following vulnerabilities: CVE-2017-12132, CVE-2017-1000366, CVE-2010-3192, CVE-2017-12133.
+
+More information about this version of the GNU C Library can be found in https://sourceware.org/ml/libc-alpha/2017-08/msg00010.html[the release notes].
--- a/modules/release-notes/pages/developers/Development_D.adoc
+++ b/modules/release-notes/pages/developers/Development_D.adoc
@ -0,0 +1,3 @@
+[[sect-d]]
+= D
+include::{partialsdir}/entities.adoc[]
--- a/modules/release-notes/pages/developers/Development_Go.adoc
+++ b/modules/release-notes/pages/developers/Development_Go.adoc
@ -0,0 +1,11 @@
+[[sect-development-go]]
+= Go
+include::{partialsdir}/entities.adoc[]
+
+
+[#go-upgraded-to-1.9]
+== Golang 1.9
+
+Fedora 27 brings Golang 1.9, which includes performance improvements, bug fixes, and new features. Most notably, support for type aliasing, parallel compilation, and direct bit manipulation has been added. For a complete list of changes, see upstream change notes at link:https://tip.golang.org/doc/go1.9[https://tip.golang.org/doc/go1.9].
+
+With this release, support for the ppc64 architecture has been left out from the Fedora Golang packages due to the fact that the ppc64 port of 'GC' is not feature-complete.
--- a/modules/release-notes/pages/developers/Development_Haskell.adoc
+++ b/modules/release-notes/pages/developers/Development_Haskell.adoc
@ -0,0 +1,3 @@
+[[sect-haskell]]
+= Haskell
+include::{partialsdir}/entities.adoc[]
--- a/modules/release-notes/pages/developers/Development_Java.adoc
+++ b/modules/release-notes/pages/developers/Development_Java.adoc
@ -0,0 +1,17 @@
+[[sect-java]]
+= Java
+include::{partialsdir}/entities.adoc[]
+
+[[sect-java-java9]]
+== Java 9 Technology Preview
+Fedora 27 includes a technology preview of Java 9, offered through the `java-9-openjdk` and `java-9-openjdk-devel` and new `java-9-openjdk-jmod` packages.
+
+Java 8 remains the default JDK for this release. The inclusion of Java 9 / OpenJDK 9 will allow developers to develop and test their applications for the next version of Java in parallel while everyone can continue using the stable Java 8 for daily use.
+
+More information about the new features of OpenJDK 9 is available from http://openjdk.java.net/projects/jdk9/[the OpenJDK website].
+
+[[sect-java-decouple]]
+== System Java Setting Decoupled from Java Command Setting
+In earlier versions of Fedora, Java applications installed from RPMs were run in the JVM that was found using the `PATH` environment variable. From this release, Java applications will be run using the default system JVM, which will be OpenJDK 8 in Fedora 27, without refering to `PATH`. Users will still be able to override the default by using the `JAVA_HOME` environment variable.
+
+More detail about this revised configuration can be found on the https://fedoraproject.org/wiki/Changes/Decouple_system_java_setting_from_java_command_setting[change page].
--- a/modules/release-notes/pages/developers/Development_Perl.adoc
+++ b/modules/release-notes/pages/developers/Development_Perl.adoc
@ -0,0 +1,22 @@
+[[sect-perl]]
+= Perl
+include::{partialsdir}/entities.adoc[]
+
+[[sect-perl-core]]
+== Packaging of the Perl Core Modules
+The release of Fedora 27 brings a change in the way that the Perl core modules are packaged by Fedora. In Perl, the core modules are the standard set of modules that ship with the Perl interpreter.  Previously in Fedora, the Perl core modules were split into a number of subpackages in such a way that installing the `perl` package did not install the full set of Perl core modules.  This behaviour was not what was expected by most Perl users and so, from Fedora 27, installing the `perl` package now installs the full set of Perl core modules. It is still possible to install only a minimal Perl interpreter by installing just the `perl-interpreter` package.
+
+[[sect-perl-526]]
+== Perl 5.26
+A new version of perl is released every year and version 5.26 is 2017's stable release. This release includes three updates with widespread effects:
+
+."." no longer in @INC
+For security reasons, the current directory (".") is no longer included by default at the end of the module search path (@INC). This may have widespread implications for the building, testing and installing of modules, and for the execution of scripts.
+
+.`do` may now warn
+`do` now gives a deprecation warning when it fails to load a file which it would have loaded had "." been in @INC.
+
+.In regular expression patterns, a literal left brace "{" must be escaped
+Unescaped literal { characters in regular expression patterns are no longer permitted. Use a pattern like "\{" or "[{]" to specify a match to a left brace.
+
+For more information about this release, please see the http://search.cpan.org/dist/perl-5.26.0/pod/perldelta.pod[5.26.0 perldelta] web page.
--- a/modules/release-notes/pages/developers/Development_Python.adoc
+++ b/modules/release-notes/pages/developers/Development_Python.adoc
@ -0,0 +1,7 @@
+[[sect-python]]
+= Python
+include::{partialsdir}/entities.adoc[]
+
+[[sect-python-sudo-pip]]
+== Making sudo pip Safe (Again)
+The location where sudo pip3 installs modules has been changed to /usr/local/lib/pythonX.Y/site-packages, and sudo pip3 is henceforth safer to use. No other changes in user experience are expected. Sudo pip3 is not considered a standard way to install Python packages. Virtual environment and pip3 install --user should still be the prefered options. Additionally, Fedora will increase it's compliance with the Filesystem Hierarchy Standard, as user-installed host-specific Python modules will now be correctly located under /usr/local.
--- a/modules/release-notes/pages/developers/Development_Ruby.adoc
+++ b/modules/release-notes/pages/developers/Development_Ruby.adoc
@ -0,0 +1,15 @@
+[[sect-ruby]]
+= Ruby
+include::{partialsdir}/entities.adoc[]
+
+[[sect-ruby-rails]]
+== Ruby on Rails 5.1
+Ruby on Rails has been updated to version 5.1 in Fedora 27.  Some of the highlights in Rails 5.1 include:
+
+* Drop jQuery as a default dependency
+* Yarn, Webpack and Capybara integration
+* Encrypted secrets support
+* Parameterized mailers support
+* Virtual/generated column support for MySQL and MariaDB
+
+For more information, please see the http://guides.rubyonrails.org/v5.1/5_1_release_notes.html[Ruby on Rails 5.1 Release Notes].
--- a/modules/release-notes/pages/developers/Development_Tools.adoc
+++ b/modules/release-notes/pages/developers/Development_Tools.adoc
@ -0,0 +1,17 @@
+[[sect-development-tools]]
+= Development Tools
+include::{partialsdir}/entities.adoc[]
+
+[[sect-development-tools-debuginfo]]
+== Debuginfo Package Improvements
+To observe what a program is doing, Fedora provides additional meta-data about code that is installed and runs on your system. These can be used together with tracers, profilers and debuggers to better understand what is running on your system (or to understand crashes or failures better). Previously, these debug info meta-data packages were fairly large, containing lots of information about multiple sub-packages together. With Fedora 27, these debug info meta-data packages have been split up into smaller sub-packages, making it possible to install just the debuginfo for one specific sub-package or library. The source files needed for debuggers (but not necessarily for tracers and profilers) have been separated out into their own debugsource package and it is now possible to install multiple, different versions or architectures of the debug info packages at the same time. For example, when trying to introspect a program installed in a container or virtual machine that is a different version of the package installed on the host, or when both a 32 bit and 64 bit version of a library is available.
+
+[[sect-development-tools-bodhi]]
+== Bodhi Now Handles Non-RPM Artifacts
+Bodhi, the https://bodhi.fedoraproject.org/[Fedora Updates System], can now handle more than just RPM files. If it can be tagged in https://koji.fedoraproject.org/koji/[Koji], it should be accepted by Bodhi. The release of Bodhi 3.0.0 enables:
+
+* Support for updating non-RPM artifacts, like modules.
+* Support for complex package dependencies, which enables Fedora to start packaging Rust packages and allows Fedora to do a better job expressing valid ranges of supported dependency versions for existing packages.
+* Support, via https://pagure.io/pungi[Pungi], for generating OSTrees that are more consistent with Fedora’s release day OSTrees.
+
+More information about this update to Bodhi can be found in the https://bodhi.fedoraproject.org/docs/release_notes.html[Bodhi 3.0.0 release notes] and the related https://fedoraproject.org/wiki/Changes/BodhiNonRPMArtifacts[Fedora change page].
--- a/modules/release-notes/pages/developers/Development_Web.adoc
+++ b/modules/release-notes/pages/developers/Development_Web.adoc
@ -0,0 +1,14 @@
+[[sect-web-development]]
+= Web Development
+include::{partialsdir}/entities.adoc[]
+
+[[sect-web-development-node]]
+== Node.js 8
+Fedora 27 includes Node.js 8, which is the current version of the platform. This release line will become a Node.js Long Term Support (LTS) release at the end of October 2017.  Some of the highlights of Node.js 8 include:
+
+* http2 support
+* experimental support for Node API (N-API)
+* a significant update to the V8 JavaScript runtime that includes major improvements in performance and developer-facing APIs
+* version 5 of the npm client
+
+For more information about the range of updates and new features introduced in Node.js 8, please see the https://medium.com/the-node-js-collection/node-js-8-big-improvements-for-the-debugging-and-native-module-ecosystem-58454861f2fc[release announcement].
--- a/modules/release-notes/pages/index.adoc
+++ b/modules/release-notes/pages/index.adoc
@ -0,0 +1,14 @@
+= Release Notes
+include::{partialsdir}/entities.adoc[]
+
+Release Notes for Fedora {PRODVER}
+
+[abstract]
+--
+This document provides the release notes for Fedora {PRODVER}. It describes major changes offered as compared to Fedora {PREVVER}.
+--
+
+image:title_logo.svg[Fedora Logo]
+include::{partialsdir}/Legal_Notice.adoc[]
+
+include::{partialsdir}/Author_Group.adoc[]
--- a/modules/release-notes/pages/sysadmin/ARM_Architectures.adoc
+++ b/modules/release-notes/pages/sysadmin/ARM_Architectures.adoc
@ -0,0 +1,9 @@
+[[sect-ARM]]
+= ARM Architectures
+include::{partialsdir}/entities.adoc[]
+
+[[sect-ARM-aarch64]]
+== aarch64 Single Board Computer Disk Images
+Fedora now includes disk images for 64 bit ARM (aarch64) Single Board Computer (SBC) devices, for example the Pine64 or Raspberry Pi 3. In the same manner as for the ARMv7 SBC images, there will be a single disk image for each of Fedora's Minimal, Server and Workstation Editions that will cover all supported devices.
+
+More information about Fedora on ARM and the supported devices can be found on the https://fedoraproject.org/wiki/Architectures/ARM[ARM Architecture page].
--- a/modules/release-notes/pages/sysadmin/Domain_Controllers.adoc
+++ b/modules/release-notes/pages/sysadmin/Domain_Controllers.adoc
@ -0,0 +1,49 @@
+[[sect-domain-controllers]]
+= Domain Controllers
+include::{partialsdir}/entities.adoc[]
+
+[[sect-domain-controllers-samba-changes]]
+== Samba changes
+
+Samba project completed conversion of Samba AD DC to support MIT Kerberos. Fedora 27 is the first Fedora version to include Samba AD domain controller functionality.
+
+The Samba AD process will take care of starting the MIT KDC and it will load a KDB (Kerberos Database) driver to access the Samba AD database.  When
+provisioning an AD DC using 'samba-tool' it will take care of creating a correct kdc.conf file for the MIT KDC.
+
+For further details, see: link:++https://wiki.samba.org/index.php/Running_a_Samba_AD_DC_with_MIT_Kerberos_KDC++[upstream's documentation].
+
+Important changes to note:
+
+* Two different deployment modes are now supported for Samba domain controller:
+    - Traditional domain controller (NT-style domain controller)
+    - Active Directory domain controller (new mode).
+* Samba upgraded to version 4.7.
+* The default for `client max protocol` has changed to `SMB3_11`, which means that `smbclient` (and related commands) will work against servers without SMB1 support. It is possible to use the `m/--max-protocol` option to overwrite the `client max protocol` option temporarily.
+* Encryption support in `smbclient` (option `-e/--encrypt`) works with SMB3 servers as well (Windows Server 2012 or later, Samba 4.0.0 or later).
+* The change to `SMB3_11` as default also means `smbclient` no longer negotiates `SMB1` unix extensions by default, when talking to a Samba server with `unix extensions = yes`.  As a result, some commands are not available, e.g. `posix_encrypt`, `posix_open`, `posix_mkdir`, `posix_rmdir`, `posix_unlink`, `posix_whoami`, `getfacl` and `symlink`. Using `-mNT1` reenables them, if the server supports SMB1.
+* `smbclient` learned a new command 'deltree' that is able to do a recursive deletion of a directory tree.
+* The dynamic port range for RPC services has been changed from the old default value `1024-1300` to `49152-65535`. This port range is not only used by a Samba AD DC, but also applies to all other server roles including NT4-style domain controllers. The new value has been defined by Microsoft in Windows Server 2008 and newer versions. To make it easier for Administrators to control those port ranges we use the same default and make it configurable with the option: `rpc server dynamic port range`. The `rpc server port` option sets the first available port from the new `rpc server dynamic port range` option. The option `rpc server port` only applies to Samba provisioned as an AD DC.
+
+Samba AD DC with MIT Kerberos does not have all the features of Heimdal Kerberos build. Missing features, compared to a Heimdal Kerberos build, are:
+
+* PKINIT support
+* S4U2SELF/S4U2PROXY support
+* Read-only domain controller support (RODC). This functionality is not fully working with Heimdal Kerberos build either.
+
+
+[[sect-domain-controllers-freeipa-changes]]
+== FreeIPA changes
+
+FreeIPA has been upgraded to version 4.6. This is a major FreeIPA release which supports Python 3.
+
+Major changes compared to FreeIPA 4.4 which was shipped in Fedora 26:
+
+* FreeIPA is using Python 3 now
+* Security defaults are in line with the rest of Fedora. In particular, newly issued certificates default to SHA-256.
+* Smartcard support was added to FreeIPA and SSSD. New `ipa-advise` recipes are available to configure FreeIPA-enrolled clients and servers to support smartcard authentication.
+* FreeIPA web UI can now be accessed using smartcard authentication. This feature is not enabled by default.
+* Kerberos PKINIT is enabled by default on new installations with an integrated Certificate Authority. This allows to use smartcards to login to FreeIPA-enrolled hosts and obtain Kerberos tickets.
+* Kerberos authentication indicator `pkinit` is automatically issued when Kerberos PKINIT pre-authentication succeeds. As result, elevated security requirements can be assigned to Kerberos services that require to only smartcard (`pkinit`), multi-factor (`otp`), or RADIUS (`radius`) authentication to succeed prior accessing them.
+* Users from trusted Active Directory domains can now login to FreeIPA web UI and perform self-service operations.
+* FreeIPA can now be installed in an environment subject to FIPS 140-2 requirements.
+
--- a/modules/release-notes/pages/sysadmin/Installation.adoc
+++ b/modules/release-notes/pages/sysadmin/Installation.adoc
@ -0,0 +1,7 @@
+[[sect-installation]]
+= Installation
+include::{partialsdir}/entities.adoc[]
+
+[[sect-installation-trim]]
+== TRIM pass down to encrypted disks
+With this change Fedora becomes more friendly to SSD drives. During the installation procedure, any newly created storage with LUKS encryption (newly formatted encrypted partitions, logical volumes, and so on) is configured to use the `discard` option which enables https://en.wikipedia.org/wiki/Trim_(computing)[TRIM]. This potentially increases the lifetime of SSD drives while **not** affecting encrypted data security and it has no effect on HDDs.
--- a/modules/release-notes/pages/sysadmin/Kernel.adoc
+++ b/modules/release-notes/pages/sysadmin/Kernel.adoc
@ -0,0 +1,3 @@
+[[sect-kernel]]
+= Kernel
+include::{partialsdir}/entities.adoc[]
--- a/modules/release-notes/pages/sysadmin/Mail_Servers.adoc
+++ b/modules/release-notes/pages/sysadmin/Mail_Servers.adoc
@ -0,0 +1,3 @@
+[[sect-mail-servers]]
+= Mail Servers
+include::{partialsdir}/entities.adoc[]
--- a/modules/release-notes/pages/sysadmin/Modularity.adoc
+++ b/modules/release-notes/pages/sysadmin/Modularity.adoc
@ -0,0 +1,21 @@
+[[sect-modularity]]
+= Fedora Modularity
+include::{partialsdir}/entities.adoc[]
+
+Modularity is the initiative to disconnect the lifecycle of applications from each other and from the lifecycle of the operating system, while still maintaining the ease of use of a typical Linux distribution. This work has produced two changes that have been incorporated into Fedora 27: Host and Platform and Modular Server.
+
+[[sect-modularity-host-platform]]
+== Host and Platform
+The Host and Platform change is an evolution of the Base Runtime module concept that was introduced in the Fedora 26 Boltron Release, splitting the minimal system further into independent modules, which gives greater flexibility when composing and maintaining the base system.
+
+* The Host module delivers hardware enablement components such as the kernel, bootloaders, firmware, possibly additional device drivers and other components closely linked to these.
+
+* The Platform module defines the operating system release and includes various base userspace components ranging from the C library and init system to system management & deployment tools, container runtime and possibly several services that are commonly considered to be part of the base system experience.
+
+The Host and Platform modules are independent, making it possible to run the same Host with different Platforms and vice versa. Each of the two modules has its own life cycle, update cadence and versioning scheme.
+
+[[sect-modularity-modular-server]]
+== Modular Server
+The Modular Server change promotes the work done in the Fedora 26 Boltron Release to the Fedora Server Edition. In Fedora 27, the Fedora Server Edition is created and delivered using the Modularity infrastructure pipeline and the Host and Platform design concept.
+
+Other Fedora Editions and Spins will not change in this release; users who want to use Fedora to create a server (as opposed to capital-S Fedora Server) without Modularity can use one of the other editions, for example the Fedora Cloud Base Image, or the "Everything" network installer.
--- a/modules/release-notes/pages/sysadmin/Packaging.adoc
+++ b/modules/release-notes/pages/sysadmin/Packaging.adoc
@ -0,0 +1,15 @@
+[[sect-packaging]]
+= Packaging
+include::{partialsdir}/entities.adoc[]
+
+[[sect-packaging-rpm]]
+== RPM 4.14
+This Fedora release contains RPM 4.14. Users' general experience of RPM will benefit from the bugfixes and from the better handling of invalid data. Packagers can take advantage of:
+
+    * Better error reporting by the macro engine
+    * Dependency generators now properly support rich (boolean) dependencies
+    * New `with`, `without` and `unless` rich operators
+
+The maximum supported header size has been significantly raised in RPM 4.14. This cannot be tracked with `rpmlib()` dependencies as that would require accessing the header, so attempting to access packages with a header larger than 32MB will cause an abrupt failure with ALL older RPM versions.
+
+For more information please see the   http://rpm.org/wiki/Releases/4.14.0[RPM 4.14 Release Notes].
--- a/modules/release-notes/pages/sysadmin/Security.adoc
+++ b/modules/release-notes/pages/sysadmin/Security.adoc
@ -0,0 +1,47 @@
+[[sect-security]]
+= Security
+include::{partialsdir}/entities.adoc[]
+
+[[sect-security-kerberos-kcm]]
+== Kerberos KCM credential cache by default
+Fedora 27 defaults to a new Kerberos credential cache type called Kerberos Cache Manager (KCM), implemented in the sssd-kcm service, that is better suited for containerized environments and also provides a better user experience in the general case. Key features of KCM include:
+
+* Kerberos credential caches are handled by a userspace deamon with a UNIX socket entry point. That means the UIDs and GIDs of the cache owners are subject to UID namespacing, which is beneficial in containerized environments.
+* The UNIX socket can be mounted into containers on demand, thus allowing one or more containers to share a single Kerberos credential cache.
+* The KCM deamon is stateful. While no functionality that benefits from that is implemented in F-27, the deamon will allow automatic refreshes of a user's Kerberos credentials if needed.
+
+Information about using KCM can be found in `man sssd-kcm` and also in `man sssd-secrets`, because KCM uses sssd-secrets for data storage.  Additional information is contained in the https://docs.pagure.org/SSSD.sssd/design_pages/kcm.html[SSSD Design Page for KCM].
+
+[[sect-security-krb5-appl]]
+== krb5-appl Packages Removed
+The `krb5-appl-clients` and `krb5-appl-servers` packages are considered to be obsolete and have been removed from Fedora. These packages provided Kerberos-aware telnet, ftp, rcp, rsh, and rlogin clients and servers. Users should to move to more modern security tools, such as openssh.
+
+
+[#sect-defauilt-ciopher-in-openvpn-changed-to-256-bit-aes-gcm]
+== Default cipher in OpenVPN changed to 256-bit AES-GCM
+
+OpenVPN configurations utilizing the newer `openvpn-server@.service` unit file now use a stronger cipher for the VPN tunnel by default. The default is changed from the Blowfish algorithm using 128-bit keys to the newer AES-GCM algorithm with 256-bit keys.
+
+To ensure backwards compatibility, this new default also enables clients still using the not recommended Blowfish algorithm to connect by utilizing the `--ncp-ciphers` feature being available in OpenVPN{nbsp}2.4.
+
+To facilitate an easy migration path away from Blowfish for clients not supporting AES-GCM, these clients can now add or change the `--cipher` option in the client configuration to either `AES-256-CBC` or `AES-128-CBC` without needing to do any other server changes.
+
+
+[#sect-openshh-server-now-follows-system-wide-crypto-policies]
+== OpenSSH Server now follows system-wide crypto policies
+
+Fedora defines system-wide crypto policies, which are followed by cryptographic libraries and tools, including OpenSSH clients. This allows administrators to use different system-wide security levels. With this update, OpenSSH Server adheres to these system-wide crypto policies, too.
+
+This modification adds environment variables that specify enabled algorithms. The information is passed to the `sshd` daemon on the command line. It is, therefore, necessary to restart the `sshd` service for changes to crypto-policy configuration to take effect.
+
+
+[#sect-ssh-1-support-removed-from-openssh]
+== SSH-1 support removed from OpenSSH
+
+The SSH-1 protocol is obsolete and no longer considered secure. As such, it is not supported by the default OpenSSH client binaries packaged for Fedora. This changes removes support for the SSH-1 protocol altogether by removing the *openssh-clients-ssh1* subpackage.
+
+
+[#sect-libcurl-switches-to-using-openssl]
+== libcurl switches to using OpenSSL
+
+The *libcurl* library now uses OpenSSL for TLS and crypto (instead of NSS). TLS certificates and keys stored in the NSS database need to be exported to files for *libcurl* to be able to load them. See link:http://pki.fedoraproject.org/wiki/NSS_Database[http://pki.fedoraproject.org/wiki/NSS_Database] for instructions on how to work with the NSS database.
--- a/modules/release-notes/pages/sysadmin/Xorg.adoc
+++ b/modules/release-notes/pages/sysadmin/Xorg.adoc
@ -0,0 +1,3 @@
+[[sect-x-org]]
+= X.Org
+include::{partialsdir}/entities.adoc[]
--- a/modules/release-notes/pages/welcome/Feedback.adoc
+++ b/modules/release-notes/pages/welcome/Feedback.adoc
@ -1,16 +1,14 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-Release_Notes-Feedback]]
-== Feedback
+= Feedback
+include::{partialsdir}/entities.adoc[]

 Thank you for taking the time to provide your comments, suggestions, and bug reports to the Fedora community; this helps improve the state of Fedora, Linux, and free software worldwide.

-=== Providing Feedback on Fedora Software
+== Providing Feedback on Fedora Software

 To provide feedback on Fedora software or other system elements, please refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests]. A list of commonly reported bugs and known issues for this release is available from link:{COMMONBUGS_URL}[Common F26 Bugs] on the wiki.

-=== Providing Feedback on Release Notes
+== Providing Feedback on Release Notes

 If you feel these release notes could be improved in any way, you can provide your feedback directly to the beat writers. There are several ways to provide feedback, in order of preference:

--- a/modules/release-notes/pages/welcome/Hardware_Overview.adoc
+++ b/modules/release-notes/pages/welcome/Hardware_Overview.adoc
@ -1,13 +1,11 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-hardware-overview]]
-== Hardware Overview
+= Hardware Overview
+include::{partialsdir}/entities.adoc[]

 Fedora {PRODVER} provides software to suit a wide variety of applications. The storage, memory and processing requirements vary depending on usage. For example, a high traffic database server requires much more memory and storage than a business desktop, which in turn has higher requirements than a single-purpose virtual machine.

 [[hardware_overview-specs]]
-=== Minimum System Configuration
+== Minimum System Configuration

 The figures below are a recommended minimum for the default installation. Your requirements may differ, and most applications will benefit from more than the minimum resources.

@ -19,28 +17,28 @@ The figures below are a recommended minimum for the default installation. Your r

 .Low memory installations
 [NOTE]
-===
+====
 Fedora {PRODVER} can be installed and used on systems with limited resources for some applications. Text, VNC, or kickstart installations are advised over graphical installation for systems with very low memory. Larger package sets require more memory during installation, so users with less than 768MB of system memory may have better results preforming a minimal install and adding to it afterward.

 For best results on systems with less than 1GB of memory, use the DVD installation image.
-===
+====

 [[hardware_overview-resolution]]
-=== Display resolution
+== Display resolution

 .Graphical Installation requires 800x600 resolution or higher
 [NOTE]
-===
+====
 Graphical installation of Fedora requires a minimum screen resolution of 800x600. Owners of devices with lower resolution, such as some netbooks, should use text or VNC installation.

 Once installed, Fedora will support these lower resolution devices. The minimum resolution requirement applies only to graphical installation.
-===
+====

 [[hardware_overview-graphics]]
-=== Graphics Hardware
+== Graphics Hardware

 [[hardware_overview-graphics-legacy_gpus]]
-==== Minimum Hardware for Accelerated Desktops
+=== Minimum Hardware for Accelerated Desktops

 Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop environments like *GNOME3* and *KDE Plasma Workspaces* use video devices to provide 3D-accelerated desktops. Older graphics hardware may *not support* acceleration:

@ -51,12 +49,12 @@ Fedora {PRODVER} supports most display adapters. Modern, feature-rich desktop en
 * Radeon prior to R300 (Radeon 9500)

 [[hardware_overview-graphics-cpu_acceleration]]
-==== CPU Accelerated Graphics
+=== CPU Accelerated Graphics

 Systems with older or no graphics acceleration devices can have accelerated desktop environments using *LLVMpipe* technology, which uses the CPU to render graphics. *LLVMpipe* requires a processor with `SSE2` extensions. The extensions supported by your processor are listed in the `flags:` section of `/proc/cpuinfo`

 [[hardware_overview-graphics-desktops]]
-==== Choosing a Desktop Environment for your hardware
+=== Choosing a Desktop Environment for your hardware

 Fedora {PRODVER}'s default desktop environment, *GNOME3*, functions best with hardware acceleration. Alternative desktops are recommended for users with older graphics hardware or those seeing insufficient performance with *LLVMpipe*.

--- a/modules/release-notes/pages/welcome/Overview.adoc
+++ b/modules/release-notes/pages/welcome/Overview.adoc
@ -1,8 +1,6 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-overview]]
-== Overview
+= Overview
+include::{partialsdir}/entities.adoc[]

 As always, Fedora continues to develop and integrate the latest free and open source software. The following sections provide a brief overview of major changes from the last release of Fedora.

--- a/modules/release-notes/pages/welcome/Welcome.adoc
+++ b/modules/release-notes/pages/welcome/Welcome.adoc
@ -1,8 +1,6 @@
-
-include::en-US/entities.adoc[]
-
 [[sect-welcome_to_fedora]]
-== Welcome to Fedora
+= Welcome to Fedora
+include::{partialsdir}/entities.adoc[]

 The Fedora Project is a partnership of Free software community members from around the globe. The Fedora Project builds open source software communities and produces a Linux distribution called Fedora.

@ -25,7 +23,7 @@ To find out more general information about Fedora, refer to the following pages,
 * link:++http://fedoraproject.org/wiki/Join++[Participate in the Fedora Project]

 [[sect-need-help]]
-=== Need Help?
+== Need Help?

 There are a number of places you can get assistance should you run into problems.

@ -34,6 +32,6 @@ If you run into a problem and would like some assistance, go to link:++http://as
 You may also find assistance on the `#fedora` channel on the IRC net `irc.freenode.net`. Keep in mind that the channel is populated by volunteers wanting to help, but folks knowledgeable about a specific topic might not always be available.

 [[sect-providing-help]]
-=== Want to Contribute?
+== Want to Contribute?

 You can help the Fedora Project community continue to improve Fedora if you file bug reports and enhancement requests. Refer to link:++http://fedoraproject.org/wiki/BugsAndFeatureRequests++[Bugs And Feature Requests] on the Fedora Wiki for more information about bug and feature reporting. Thank you for your participation.
--- a/preview.sh
+++ b/preview.sh
@ -0,0 +1,18 @@
+#!/bin/sh
+
+if [ "$(uname)" = "Darwin" ]; then
+    # Running on macOS.
+    # Let's assume that the user has the Docker CE installed
+    # which doesn't require a root password.
+    echo "The preview will be available at http://localhost:8080/"
+    docker run --rm -v $(pwd):/antora:ro -v $(pwd)/nginx.conf:/etc/nginx/conf.d/default.conf:ro -p 8080:80 nginx
+
+elif [ "$(expr substr "$(uname -s)" 1 5)" = "Linux" ]; then
+    # Running on Linux.
+    # Fedora Workstation has python3 installed as a default, so using that
+    echo ""
+    echo "The preview is available at http://localhost:8080"
+    echo ""
+    cd ./public
+    python3 -m http.server 8080
+fi
--- a/site.yml
+++ b/site.yml
@ -0,0 +1,22 @@
+site: 
+  title: Local Preview
+  start_page: fedora:release-notes:index.adoc
+content:
+  sources:
+   - url: https://pagure.io/forks/bex/fedora-docs/docs-fp-o.git
+     branches: antora_f27
+   - url: .
+     branches: HEAD
+ui:
+  bundle:
+    url: https://asamalik.fedorapeople.org/ui-bundle.zip
+    snapshot: true
+  default_layout: with_menu
+output: 
+  clean: true 
+  dir: ./public
+  destinations: 
+  - provider: archive 
+runtime:
+  fetch: true
+  cache_dir: ./cache
Author	SHA1	Message	Date
Petr Bokoc	7a581f2d24	Fix build/preview scripts	2022-03-09 16:46:08 +01:00
Timothée Ravier	9347048733	Update configuration for Antora 3.0	2022-03-09 16:46:08 +01:00
Timothée Ravier	eabe1fed0a	build & preview: Update with latest version from template	2022-03-09 16:46:08 +01:00
Adam Samalik	8d923c7be8	add readme	2018-07-28 14:50:53 +02:00
Brian (bex) Exelbierd	34621ca808	make nav better for shared display	2018-07-28 13:15:11 +02:00
Brian (bex) Exelbierd	8de87dfbfe	antora conversion	2018-07-28 11:32:13 +02:00
Robert Krátký	861fa22207	Typo.	2017-11-03 15:33:49 +01:00
Robert Krátký	0392022836	Update crypto-policy info based jjelen's feedback.	2017-11-03 15:31:57 +01:00
Simon Clark	03a8c87d87	Add #16 'RPM 4.14'	2017-11-01 23:01:47 +00:00
Simon Clark	bf7b33dd7c	Fix formatting in Modularity.adoc	2017-11-01 21:37:17 +00:00
Simon Clark	89da79bcdb	Fix alignment of topics in _topic_map.yml	2017-11-01 21:31:05 +00:00
Simon Clark	8388564528	Fix headings in Madularity.adoc	2017-11-01 21:00:29 +00:00
Simon Clark	7ff19c30bf	Reinstate Modularity in _topic_map.yml	2017-11-01 20:58:21 +00:00
Simon Clark	c4424e6fe4	Add #20 #21 #23 'Modular Server Release' - updated	2017-11-01 20:34:06 +00:00
Brian (bex) Exelbierd	5242b6e9ff	Fix notes in Hardware Overview	2017-11-01 10:29:28 +01:00
Brian (bex) Exelbierd	e90a042ed5	Demote headers to fix double header in site Also move includes under the H1	2017-11-01 10:21:23 +01:00
Brian (bex) Exelbierd	0c6b5f0fd1	Dropping Revision History It does not appear to be being maintained	2017-11-01 10:02:11 +01:00
Brian (bex) Exelbierd	6aaa0ad460	Dropping blank pages Commented out blank pages in _topic_map.yml to keep them out of the output	2017-11-01 10:01:29 +01:00
Simon Clark	80e65ea06e	Add #26 'aarch64 SBC disk images' - updated	2017-10-31 21:36:57 +00:00
Simon Clark	41d72803c0	Add #20 #21 #23 'Modular Server Release'	2017-10-31 12:34:53 +00:00
Robert Krátký	42fefbee30	Add info to Go note based on jcajka input.	2017-10-30 13:10:44 +01:00
Robert Krátký	1a826d8ecb	Typo.	2017-10-30 10:20:19 +01:00
Robert Krátký	3c1c2770d7	#12 , Switch libcurl back to OpenSSL.	2017-10-29 16:32:39 +01:00
Robert Krátký	c4bd336d97	#13 , Golang 1.9.	2017-10-29 16:19:52 +01:00
Robert Krátký	a515a70672	#30 , Remove SSH-1 from OpenSSH clients.	2017-10-29 16:04:53 +01:00
Robert Krátký	7fd3e9b5f8	#32 , OpenSSH Server Crypto Policy.	2017-10-29 15:58:44 +01:00
Robert Krátký	a6f75a6780	#33 , New default cipher in OpenVPN.	2017-10-29 15:43:08 +01:00
Simon Clark	c53d973714	Add #39 'Bodhi Non-RPM Artifacts'	2017-10-27 15:52:29 +01:00
Simon Clark	e6be166943	Add #26 'aarch64 SBC disk images'	2017-10-26 21:57:16 +01:00
Simon Clark	090aa63d60	Add #37 'System java setting'	2017-10-26 20:25:56 +01:00
Simon Clark	b99ac19523	Add #35 'Java 9 Technology Preview' - updated	2017-10-26 06:59:10 +01:00
Simon Clark	4bfb9823f7	Add #29 'Remove krb5-appl'	2017-10-24 16:16:01 +01:00
Simon Clark	73da51ecee	Add #35 'Java 9 Technology Preview'	2017-10-24 14:45:14 +01:00
Simon Clark	cab0bf9f20	Add #6 'TRIM pass down to encrypted disks'	2017-10-24 10:52:06 +01:00
Alexander Bokovoy	e9ba864dec	Add section about changes in domain controllers (FreeIPA and Samba)	2017-10-16 09:14:30 +03:00
Simon Clark	0834683ef7	Add #28 'Replace Yumex-DNF with dnfdragora' after review and update	2017-10-13 17:58:27 +01:00
Simon Clark	54551ecdf3	Add #28 'Replace Yumex-DNF with dnfdragora'	2017-10-13 16:12:22 +01:00
Simon Clark	297698a559	Add #24 'GNU C Library 2.26'	2017-10-13 14:57:37 +01:00
Simon Clark	41bf434c57	Add #15 'Ruby on Rails 5.1' following review	2017-10-12 19:43:24 +01:00
Simon Clark	21226eb382	Add #15 'Ruby on Rails 5.1'	2017-10-12 18:21:09 +01:00
Simon Clark	98143b94f0	Add #22 'Kerberos KCM credential cache by default' following review - closes #22	2017-10-12 05:42:35 +01:00
Simon Clark	7427de2cbf	Merge branch 'f27' into iss22	2017-10-12 05:35:49 +01:00
Simon Clark	ac8370e707	Update #17 after review feedback	2017-10-12 05:07:19 +01:00
Simon Clark	13cf2e66b6	Merge branch 'f27' into iss17	2017-10-12 05:03:43 +01:00
Simon Clark	13aeac5c3f	Merge branch 'f27' into iss18	2017-10-10 21:38:34 +01:00
Simon Clark	8e0ddf84f2	Update #18 'Node.js 8.x' incorporating feedback	2017-10-10 20:32:47 +01:00
Simon Clark	f5a39de042	Add #14 and #17 'Separate Subpackage and Source Debuginfo'	2017-10-09 20:22:05 +01:00
Simon Clark	6b71f2c6e3	Add #22 'Kerberos KCM credential cache by default'	2017-10-09 16:04:54 +01:00
Simon Clark	b40684a8e8	Add #10 ('Perl 5.26') updated wording	2017-10-09 12:45:23 +01:00
Simon Clark	e71e834e34	Add #18 'Node.js 8.x'	2017-10-07 19:14:46 +01:00
Simon Clark	e655593870	Merge branch 'f27' into iss10	2017-10-07 15:52:46 +01:00
Simon Clark	4aacccf85b	Add #10 'Perl 5.26'	2017-10-07 15:06:04 +01:00
mcyprian	403417adf0	Add #34 'Making sudo pip Safe (Again)'	2017-10-05 09:07:55 +00:00
Simon Clark	469f3c89da	Add #11 'perl Package to Install Core Modules'	2017-10-02 12:00:07 +01:00
Simon Clark	2d36c159b2	Add #5 'Boost 1.64 upgrade'	2017-09-30 20:16:39 +01:00
Simon Clark	03cd200ec3	Remove F26 content	2017-09-29 14:31:51 +01:00
Brian (bex) Exelbierd	fff5f75de4	Branching for F27	2017-09-24 17:00:21 +02:00