diff --git a/docs/.gitignore b/docs/.gitignore new file mode 100644 index 0000000000..ca35be08d4 --- /dev/null +++ b/docs/.gitignore @@ -0,0 +1 @@ +_site diff --git a/docs/AUTOMATIC_BOOT_ASSESSMENT.md b/docs/AUTOMATIC_BOOT_ASSESSMENT.md index 6df638417e..c7f5bb35f8 100644 --- a/docs/AUTOMATIC_BOOT_ASSESSMENT.md +++ b/docs/AUTOMATIC_BOOT_ASSESSMENT.md @@ -1,6 +1,7 @@ --- title: Automatic Boot Assessment category: Booting +layout: default --- # Automatic Boot Assessment diff --git a/docs/BLOCK_DEVICE_LOCKING.md b/docs/BLOCK_DEVICE_LOCKING.md index 491b22c95c..f122eda417 100644 --- a/docs/BLOCK_DEVICE_LOCKING.md +++ b/docs/BLOCK_DEVICE_LOCKING.md @@ -1,6 +1,7 @@ --- title: Locking Block Device Access category: Interfaces +layout: default --- # Locking Block Device Access diff --git a/docs/BOOT_LOADER_INTERFACE.md b/docs/BOOT_LOADER_INTERFACE.md index 4fe65467f9..ba88fe72cc 100644 --- a/docs/BOOT_LOADER_INTERFACE.md +++ b/docs/BOOT_LOADER_INTERFACE.md @@ -1,6 +1,7 @@ --- title: The Boot Loader Interface category: Booting +layout: default --- # The Boot Loader Interface diff --git a/docs/BOOT_LOADER_SPECIFICATION.md b/docs/BOOT_LOADER_SPECIFICATION.md index 0bdf3570a8..59c87dd121 100644 --- a/docs/BOOT_LOADER_SPECIFICATION.md +++ b/docs/BOOT_LOADER_SPECIFICATION.md @@ -1,6 +1,7 @@ --- title: The Boot Loader Specification category: Booting +layout: default --- # The Boot Loader Specification diff --git a/docs/CGROUP_DELEGATION.md b/docs/CGROUP_DELEGATION.md index 1902c467ad..da4e38c655 100644 --- a/docs/CGROUP_DELEGATION.md +++ b/docs/CGROUP_DELEGATION.md @@ -1,6 +1,7 @@ --- title: Control Group APIs and Delegation category: Interfaces +layout: default --- # Control Group APIs and Delegation diff --git a/docs/CODE_OF_CONDUCT.md b/docs/CODE_OF_CONDUCT.md index 30e966d29e..b0925691c9 100644 --- a/docs/CODE_OF_CONDUCT.md +++ b/docs/CODE_OF_CONDUCT.md @@ -1,6 +1,7 @@ --- title: The systemd Community Conduct Guidelines category: Contributing +layout: default --- # The systemd Community Conduct Guidelines diff --git a/docs/CODE_QUALITY.md b/docs/CODE_QUALITY.md index 28f262d1f2..9f261474ac 100644 --- a/docs/CODE_QUALITY.md +++ b/docs/CODE_QUALITY.md @@ -1,6 +1,7 @@ --- title: Code Quality Tools category: Contributing +layout: default --- # Code Quality Tools diff --git a/docs/CODING_STYLE.md b/docs/CODING_STYLE.md index c2eb902eb4..9e480a649e 100644 --- a/docs/CODING_STYLE.md +++ b/docs/CODING_STYLE.md @@ -1,6 +1,7 @@ --- title: Coding Style category: Contributing +layout: default --- # Coding Style diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md index 9459a3fe82..0ee71b274c 100644 --- a/docs/CONTRIBUTING.md +++ b/docs/CONTRIBUTING.md @@ -1,6 +1,7 @@ --- title: Contributing category: Contributing +layout: default --- # Contributing diff --git a/docs/DISTRO_PORTING.md b/docs/DISTRO_PORTING.md index 5d62a08c06..2e4782f401 100644 --- a/docs/DISTRO_PORTING.md +++ b/docs/DISTRO_PORTING.md @@ -1,6 +1,7 @@ --- title: Porting systemd To New Distributions category: Concepts +layout: default --- # Porting systemd To New Distributions diff --git a/docs/ENVIRONMENT.md b/docs/ENVIRONMENT.md index 7d51e40011..9b1df6b59c 100644 --- a/docs/ENVIRONMENT.md +++ b/docs/ENVIRONMENT.md @@ -1,6 +1,7 @@ --- title: Known Environment Variables category: Interfaces +layout: default --- # Known Environment Variables diff --git a/docs/HACKING.md b/docs/HACKING.md index 98139198c1..db9ed1a01e 100644 --- a/docs/HACKING.md +++ b/docs/HACKING.md @@ -1,6 +1,7 @@ --- title: Hacking on systemd category: Contributing +layout: default --- # Hacking on systemd diff --git a/docs/PORTABLE_SERVICES.md b/docs/PORTABLE_SERVICES.md index 7216f2105a..d9c838f982 100644 --- a/docs/PORTABLE_SERVICES.md +++ b/docs/PORTABLE_SERVICES.md @@ -1,6 +1,7 @@ --- title: Portable Services Introduction category: Concepts +layout: default --- # Portable Services Introduction diff --git a/docs/PREDICTABLE_INTERFACE_NAMES.md b/docs/PREDICTABLE_INTERFACE_NAMES.md index ff3d0fb3ad..1a098f2467 100644 --- a/docs/PREDICTABLE_INTERFACE_NAMES.md +++ b/docs/PREDICTABLE_INTERFACE_NAMES.md @@ -1,6 +1,7 @@ --- title: Predictable Network Interface Names category: Concepts +layout: default --- # Predictable Network Interface Names diff --git a/docs/RANDOM_SEEDS.md b/docs/RANDOM_SEEDS.md index ef7df412dd..d3b68e967a 100644 --- a/docs/RANDOM_SEEDS.md +++ b/docs/RANDOM_SEEDS.md @@ -1,6 +1,7 @@ --- title: Random Seeds category: Concepts +layout: default --- # Random Seeds diff --git a/docs/RELEASE.md b/docs/RELEASE.md index 3cb79fd182..b56635a211 100644 --- a/docs/RELEASE.md +++ b/docs/RELEASE.md @@ -1,6 +1,7 @@ --- title: Steps to a Successful Release category: Contributing +layout: default --- # Steps to a Successful Release diff --git a/docs/SECURITY.md b/docs/SECURITY.md index a060e4547b..05f9330561 100644 --- a/docs/SECURITY.md +++ b/docs/SECURITY.md @@ -1,6 +1,7 @@ --- title: Reporting of security vulnerabilities category: Contributing +layout: default --- # Reporting of security vulnerabilities diff --git a/docs/TEMPORARY_DIRECTORIES.md b/docs/TEMPORARY_DIRECTORIES.md index 1a27b795ce..5bb24fa3ee 100644 --- a/docs/TEMPORARY_DIRECTORIES.md +++ b/docs/TEMPORARY_DIRECTORIES.md @@ -1,6 +1,7 @@ --- title: Using /tmp/ And /var/tmp/ Safely category: Interfaces +layout: default --- # Using `/tmp/` And `/var/tmp/` Safely diff --git a/docs/TESTING_WITH_SANITIZERS.md b/docs/TESTING_WITH_SANITIZERS.md index 6c3465aac2..4d58d0f2b2 100644 --- a/docs/TESTING_WITH_SANITIZERS.md +++ b/docs/TESTING_WITH_SANITIZERS.md @@ -1,6 +1,7 @@ --- title: Testing systemd using sanitizers category: Contributing +layout: default --- # Testing systemd using sanitizers diff --git a/docs/TRANSIENT-SETTINGS.md b/docs/TRANSIENT-SETTINGS.md index 549ec678fc..e9122d5b2b 100644 --- a/docs/TRANSIENT-SETTINGS.md +++ b/docs/TRANSIENT-SETTINGS.md @@ -1,6 +1,7 @@ --- title: What settings are currently available for transient units? category: Interfaces +layout: default --- # What settings are currently available for transient units? diff --git a/docs/TRANSLATORS.md b/docs/TRANSLATORS.md index f9e7105ac8..f4553f559d 100644 --- a/docs/TRANSLATORS.md +++ b/docs/TRANSLATORS.md @@ -1,6 +1,7 @@ --- title: Notes for Translators category: Contributing +layout: default --- # Notes for Translators diff --git a/docs/UIDS-GIDS.md b/docs/UIDS-GIDS.md index d92b055fec..e70c23a362 100644 --- a/docs/UIDS-GIDS.md +++ b/docs/UIDS-GIDS.md @@ -1,6 +1,7 @@ --- title: Users, Groups, UIDs and GIDs on `systemd` Systems category: Concepts +layout: default --- # Users, Groups, UIDs and GIDs on `systemd` Systems diff --git a/docs/_config.yml b/docs/_config.yml index ee845eec80..925b4adb14 100644 --- a/docs/_config.yml +++ b/docs/_config.yml @@ -1 +1,9 @@ -theme: jekyll-theme-primer +# Site settings +title: systemd +baseurl: "" # the subpath of your site, e.g. /blog/ +url: "http://systemd.io" # the base hostname & protocol for your site + +permalink: /:title/ + +# Build settings +markdown: kramdown diff --git a/docs/_includes/footer.html b/docs/_includes/footer.html new file mode 100644 index 0000000000..d8c1535f28 --- /dev/null +++ b/docs/_includes/footer.html @@ -0,0 +1,5 @@ + diff --git a/docs/_includes/head.html b/docs/_includes/head.html new file mode 100644 index 0000000000..3ff4bbe0b8 --- /dev/null +++ b/docs/_includes/head.html @@ -0,0 +1,16 @@ + + + + + + + {% if page.title %}{{ page.title }}{% else %}{{ site.title }}{% endif %} + + + + + + + + + diff --git a/docs/_includes/header.html b/docs/_includes/header.html new file mode 100644 index 0000000000..4e885fbe71 --- /dev/null +++ b/docs/_includes/header.html @@ -0,0 +1,11 @@ +
+ +
+ + + +
+ +
diff --git a/docs/_layouts/default.html b/docs/_layouts/default.html new file mode 100644 index 0000000000..672aa0cd58 --- /dev/null +++ b/docs/_layouts/default.html @@ -0,0 +1,18 @@ + + + + {% include head.html %} + + + + {% include header.html %} + +
+ {{ content }} +
+ + {% include footer.html %} + + + + diff --git a/docs/assets/page-logo.svg b/docs/assets/page-logo.svg new file mode 100644 index 0000000000..e59c88af38 --- /dev/null +++ b/docs/assets/page-logo.svg @@ -0,0 +1,6 @@ + + + + + + diff --git a/docs/favicon.png b/docs/favicon.png new file mode 100644 index 0000000000..f4b5cc146a Binary files /dev/null and b/docs/favicon.png differ diff --git a/docs/favicon.svg b/docs/favicon.svg new file mode 100644 index 0000000000..9ffaf5933c --- /dev/null +++ b/docs/favicon.svg @@ -0,0 +1,10 @@ + + + + + + + + + + diff --git a/docs/fonts/heebo-bold.woff b/docs/fonts/heebo-bold.woff new file mode 100644 index 0000000000..1e45115e1e Binary files /dev/null and b/docs/fonts/heebo-bold.woff differ diff --git a/docs/fonts/heebo-regular.woff b/docs/fonts/heebo-regular.woff new file mode 100644 index 0000000000..484eae4555 Binary files /dev/null and b/docs/fonts/heebo-regular.woff differ diff --git a/docs/index.md b/docs/index.md index 2969162a2a..0368417184 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,8 +1,16 @@ --- -title: systemd Documentation +layout: default --- -# systemd Documentation +systemd is a suite of basic building blocks for a Linux system. It provides a system and service manager that runs as PID 1 and starts the rest of the system. + +systemd provides aggressive parallelization capabilities, uses socket and D-Bus activation for starting services, offers on-demand starting of daemons, keeps track of processes using Linux control groups, maintains mount and automount points, and implements an elaborate transactional dependency-based service control logic. systemd supports SysV and LSB init scripts and works as a replacement for sysvinit. + +Other parts include a logging daemon, utilities to control basic system configuration like the hostname, date, locale, maintain a list of logged-in users and running containers and virtual machines, system accounts, runtime directories and settings, and daemons to manage simple network configuration, network time synchronization, log forwarding, and name resolution. + +See the introductory blog story and three status updates for a longer introduction. Also see the [Wikipedia article](https://en.wikipedia.org/wiki/systemd). + +--- {% assign by_category = site.pages | group_by:"category" %} {% assign extra_pages = site.data.extra_pages | group_by:"category" %} @@ -15,3 +23,4 @@ title: systemd Documentation * [{{ page.title }}]({{ page.url | relative_url }}){% endfor %} {% endif %} {% endfor %} + diff --git a/docs/style.css b/docs/style.css new file mode 100755 index 0000000000..8a2ae719da --- /dev/null +++ b/docs/style.css @@ -0,0 +1,347 @@ +@font-face { + font-family: 'Heebo'; + src: url('fonts/heebo-regular.woff'); + font-weight: 400; +} + +@font-face { + font-family: 'Heebo'; + src: url('fonts/heebo-bold.woff'); + font-weight: 600; +} + +/* Typography */ +* { + -moz-box-sizing: border-box; + -webkit-box-sizing: border-box; + box-sizing: border-box; +} +html, body { + margin: 0; + padding: 0; + font-size: 16px; + font-family: "Heebo", sans-serif; + font-weight: 400; + line-height: 1.6; +} +body { + color: #241f31; + background-color: #f6f5f4; +} +h1, h2, h3, h4, h5, h6 { + margin: 1rem 0 10px; + font-weight: 600; + line-height: 1.25; +} +h1 { + text-align: center; + font-size: 30px; + font-weight: 100; + font-style: normal; + margin-bottom: 2rem; +} +@media screen and (min-width: 650px) { + h1 { + margin-left: 10%; + margin-right: 10%; + font-size: 38px; + } +} +h2 { + margin-top: 3rem; + font-size: 1.2rem; +} +a { + font-weight: 600; + text-decoration: none; + color: #26b763; + cursor: pointer; +} +a:hover { + text-decoration: underline; +} +b { + font-weight: 600; +} +small { + color: #777; +} +hr { + margin: 3rem auto 4rem; + width: 40%; + opacity: 40%; +} + +/* Layout */ +.container { + width: 80%; + margin-left: auto; + margin-right: auto; + max-width: 720px; +} + +/* Singletons */ +.page-logo { + display: block; + padding: 5rem 0 3rem; +} +.page-logo > img { + display: block; + margin: 0 auto; +} + +.brand-white { + background-color: #fff; +} + +.brand-green { + background-color: #30D475; +} + +.brand-black { + background-color: #201A26; + color: white; +} + +.page-link::after { + content: " ➜"; +} + + +/* Footer */ +footer { + text-align: center; + padding: 3em 0 3em; + font-size: 1em; + margin-top: 4rem; +} + +/* Github Code Highlighting */ +.highlight table td { padding: 5px; } +.highlight table pre { margin: 0; } +.highlight .cm { + color: #999988; + font-style: italic; +} +.highlight .cp { + color: #999999; + font-weight: bold; +} +.highlight .c1 { + color: #999988; + font-style: italic; +} +.highlight .cs { + color: #999999; + font-weight: bold; + font-style: italic; +} +.highlight .c, .highlight .ch, .highlight .cd, .highlight .cpf { + color: #999988; + font-style: italic; +} +.highlight .err { + color: #a61717; + background-color: #e3d2d2; +} +.highlight .gd { + color: #000000; + background-color: #ffdddd; +} +.highlight .ge { + color: #000000; + font-style: italic; +} +.highlight .gr { + color: #aa0000; +} +.highlight .gh { + color: #999999; +} +.highlight .gi { + color: #000000; + background-color: #ddffdd; +} +.highlight .go { + color: #888888; +} +.highlight .gp { + color: #555555; +} +.highlight .gs { + font-weight: bold; +} +.highlight .gu { + color: #aaaaaa; +} +.highlight .gt { + color: #aa0000; +} +.highlight .kc { + color: #000000; + font-weight: bold; +} +.highlight .kd { + color: #000000; + font-weight: bold; +} +.highlight .kn { + color: #000000; + font-weight: bold; +} +.highlight .kp { + color: #000000; + font-weight: bold; +} +.highlight .kr { + color: #000000; + font-weight: bold; +} +.highlight .kt { + color: #445588; + font-weight: bold; +} +.highlight .k, .highlight .kv { + color: #000000; + font-weight: bold; +} +.highlight .mf { + color: #009999; +} +.highlight .mh { + color: #009999; +} +.highlight .il { + color: #009999; +} +.highlight .mi { + color: #009999; +} +.highlight .mo { + color: #009999; +} +.highlight .m, .highlight .mb, .highlight .mx { + color: #009999; +} +.highlight .sb { + color: #d14; +} +.highlight .sc { + color: #d14; +} +.highlight .sd { + color: #d14; +} +.highlight .s2 { + color: #d14; +} +.highlight .se { + color: #d14; +} +.highlight .sh { + color: #d14; +} +.highlight .si { + color: #d14; +} +.highlight .sx { + color: #d14; +} +.highlight .sr { + color: #009926; +} +.highlight .s1 { + color: #d14; +} +.highlight .ss { + color: #990073; +} +.highlight .s, .highlight .sa, .highlight .dl { + color: #d14; +} +.highlight .na { + color: #008080; +} +.highlight .bp { + color: #999999; +} +.highlight .nb { + color: #0086B3; +} +.highlight .nc { + color: #445588; + font-weight: bold; +} +.highlight .no { + color: #008080; +} +.highlight .nd { + color: #3c5d5d; + font-weight: bold; +} +.highlight .ni { + color: #800080; +} +.highlight .ne { + color: #990000; + font-weight: bold; +} +.highlight .nf, .highlight .fm { + color: #990000; + font-weight: bold; +} +.highlight .nl { + color: #990000; + font-weight: bold; +} +.highlight .nn { + color: #555555; +} +.highlight .nt { + color: #000080; +} +.highlight .vc { + color: #008080; +} +.highlight .vg { + color: #008080; +} +.highlight .vi { + color: #008080; +} +.highlight .nv, .highlight .vm { + color: #008080; +} +.highlight .ow { + color: #000000; + font-weight: bold; +} +.highlight .o { + color: #000000; + font-weight: bold; +} +.highlight .w { + color: #bbbbbb; +} +.highlight { + background-color: #f8f8f8; +} + + +/* Code Blocks */ +.highlighter-rouge { + padding: 2px 1rem; + border-radius: 5px; + background-color: white; + + overflow: auto; +} +.highlighter-rouge * { + background-color: white; +} + +/* Inline Code */ +code.highlighter-rouge { + padding: 2px 6px; + background-color: rgba(0,0,0, 0.07); +}