Compare commits

..

2 Commits

Author SHA1 Message Date
Tobias Bernard 8fb82e35dc minor: avoid double title
The logo and H1 were clashing a bit
2019-12-11 19:57:57 +01:00
Tobias Bernard b41a3f66c9 docs: make it pretty
Add custom Jekyll theme, logo, webfont and .gitignore

FIXME: the markdown files have some H1 headers which need to be replaced
with H2
2019-12-11 17:04:20 +01:00
36 changed files with 458 additions and 5 deletions

View File

@ -1,6 +1,6 @@
![systemd logo](http://brand.systemd.io/assets/page-logo.png) ![Systemd](http://brand.systemd.io/assets/page-logo.png)
# systemd - System and Service Manager System and Service Manager
<a href="https://in.waw.pl/systemd-github-state/systemd-systemd-issues.svg"><img align="right" src="https://in.waw.pl/systemd-github-state/systemd-systemd-issues-small.svg" alt="Count of open issues over time"></a> <a href="https://in.waw.pl/systemd-github-state/systemd-systemd-issues.svg"><img align="right" src="https://in.waw.pl/systemd-github-state/systemd-systemd-issues-small.svg" alt="Count of open issues over time"></a>
<a href="https://in.waw.pl/systemd-github-state/systemd-systemd-pull-requests.svg"><img align="right" src="https://in.waw.pl/systemd-github-state/systemd-systemd-pull-requests-small.svg" alt="Count of open pull requests over time"></a> <a href="https://in.waw.pl/systemd-github-state/systemd-systemd-pull-requests.svg"><img align="right" src="https://in.waw.pl/systemd-github-state/systemd-systemd-pull-requests-small.svg" alt="Count of open pull requests over time"></a>

1
docs/.gitignore vendored Normal file
View File

@ -0,0 +1 @@
_site

View File

@ -1,6 +1,7 @@
--- ---
title: Automatic Boot Assessment title: Automatic Boot Assessment
category: Booting category: Booting
layout: default
--- ---
# Automatic Boot Assessment # Automatic Boot Assessment

View File

@ -1,6 +1,7 @@
--- ---
title: Locking Block Device Access title: Locking Block Device Access
category: Interfaces category: Interfaces
layout: default
--- ---
# Locking Block Device Access # Locking Block Device Access

View File

@ -1,6 +1,7 @@
--- ---
title: The Boot Loader Interface title: The Boot Loader Interface
category: Booting category: Booting
layout: default
--- ---
# The Boot Loader Interface # The Boot Loader Interface

View File

@ -1,6 +1,7 @@
--- ---
title: The Boot Loader Specification title: The Boot Loader Specification
category: Booting category: Booting
layout: default
--- ---
# The Boot Loader Specification # The Boot Loader Specification

View File

@ -1,6 +1,7 @@
--- ---
title: Control Group APIs and Delegation title: Control Group APIs and Delegation
category: Interfaces category: Interfaces
layout: default
--- ---
# Control Group APIs and Delegation # Control Group APIs and Delegation

View File

@ -1,6 +1,7 @@
--- ---
title: The systemd Community Conduct Guidelines title: The systemd Community Conduct Guidelines
category: Contributing category: Contributing
layout: default
--- ---
# The systemd Community Conduct Guidelines # The systemd Community Conduct Guidelines

View File

@ -1,6 +1,7 @@
--- ---
title: Code Quality Tools title: Code Quality Tools
category: Contributing category: Contributing
layout: default
--- ---
# Code Quality Tools # Code Quality Tools

View File

@ -1,6 +1,7 @@
--- ---
title: Coding Style title: Coding Style
category: Contributing category: Contributing
layout: default
--- ---
# Coding Style # Coding Style

View File

@ -1,6 +1,7 @@
--- ---
title: Contributing title: Contributing
category: Contributing category: Contributing
layout: default
--- ---
# Contributing # Contributing

View File

@ -1,6 +1,7 @@
--- ---
title: Porting systemd To New Distributions title: Porting systemd To New Distributions
category: Concepts category: Concepts
layout: default
--- ---
# Porting systemd To New Distributions # Porting systemd To New Distributions

View File

@ -1,6 +1,7 @@
--- ---
title: Known Environment Variables title: Known Environment Variables
category: Interfaces category: Interfaces
layout: default
--- ---
# Known Environment Variables # Known Environment Variables

View File

@ -1,6 +1,7 @@
--- ---
title: Hacking on systemd title: Hacking on systemd
category: Contributing category: Contributing
layout: default
--- ---
# Hacking on systemd # Hacking on systemd

View File

@ -1,6 +1,7 @@
--- ---
title: Portable Services Introduction title: Portable Services Introduction
category: Concepts category: Concepts
layout: default
--- ---
# Portable Services Introduction # Portable Services Introduction

View File

@ -1,6 +1,7 @@
--- ---
title: Predictable Network Interface Names title: Predictable Network Interface Names
category: Concepts category: Concepts
layout: default
--- ---
# Predictable Network Interface Names # Predictable Network Interface Names

View File

@ -1,6 +1,7 @@
--- ---
title: Random Seeds title: Random Seeds
category: Concepts category: Concepts
layout: default
--- ---
# Random Seeds # Random Seeds

View File

@ -1,6 +1,7 @@
--- ---
title: Steps to a Successful Release title: Steps to a Successful Release
category: Contributing category: Contributing
layout: default
--- ---
# Steps to a Successful Release # Steps to a Successful Release

View File

@ -1,6 +1,7 @@
--- ---
title: Reporting of security vulnerabilities title: Reporting of security vulnerabilities
category: Contributing category: Contributing
layout: default
--- ---
# Reporting of security vulnerabilities # Reporting of security vulnerabilities

View File

@ -1,6 +1,7 @@
--- ---
title: Using /tmp/ And /var/tmp/ Safely title: Using /tmp/ And /var/tmp/ Safely
category: Interfaces category: Interfaces
layout: default
--- ---
# Using `/tmp/` And `/var/tmp/` Safely # Using `/tmp/` And `/var/tmp/` Safely

View File

@ -1,6 +1,7 @@
--- ---
title: Testing systemd using sanitizers title: Testing systemd using sanitizers
category: Contributing category: Contributing
layout: default
--- ---
# Testing systemd using sanitizers # Testing systemd using sanitizers

View File

@ -1,6 +1,7 @@
--- ---
title: What settings are currently available for transient units? title: What settings are currently available for transient units?
category: Interfaces category: Interfaces
layout: default
--- ---
# What settings are currently available for transient units? # What settings are currently available for transient units?

View File

@ -1,6 +1,7 @@
--- ---
title: Notes for Translators title: Notes for Translators
category: Contributing category: Contributing
layout: default
--- ---
# Notes for Translators # Notes for Translators

View File

@ -1,6 +1,7 @@
--- ---
title: Users, Groups, UIDs and GIDs on `systemd` Systems title: Users, Groups, UIDs and GIDs on `systemd` Systems
category: Concepts category: Concepts
layout: default
--- ---
# Users, Groups, UIDs and GIDs on `systemd` Systems # Users, Groups, UIDs and GIDs on `systemd` Systems

View File

@ -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

View File

@ -0,0 +1,5 @@
<footer class="site-footer">
<p>&copy; systemd, 2019</p>
<p><a href="https://github.com/systemd/systemd">Website source</a></p>
</footer>

16
docs/_includes/head.html Normal file
View File

@ -0,0 +1,16 @@
<head>
<meta charset="utf-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="theme-color" content="#0021D8">
<title>{% if page.title %}{{ page.title }}{% else %}{{ site.title }}{% endif %}</title>
<link rel="canonical" href="{{ page.url | replace:'index.html','' | prepend: site.baseurl | prepend: site.url }}">
<link rel="alternate" type="application/rss+xml" title="{{ site.title }}" href="{{ "/feed.xml" | prepend: site.baseurl | prepend: site.url }}" />
<link rel="stylesheet" href="{{ "/style.css" | prepend: site.baseurl }}">
<link rel="icon" type="image/png" href="/favicon.png" />
<link rel="icon" sizes="144x144" href="apple-touch-icon.png">
</head>

View File

@ -0,0 +1,11 @@
<header class="site-header">
<div class="wrapper">
<a class="page-logo" href="{{ site.baseurl }}/">
<img src="/assets/page-logo.svg" alt="systemd">
</a>
</div>
</header>

View File

@ -0,0 +1,18 @@
<!DOCTYPE html>
<html>
{% include head.html %}
<body>
{% include header.html %}
<div class="container">
{{ content }}
</div>
{% include footer.html %}
</body>
</html>

View File

@ -0,0 +1,6 @@
<svg xmlns="http://www.w3.org/2000/svg" width="202" height="26">
<path overflow="visible" font-weight="400" d="M0 0v26h10v-4H4V4h6V0zm76 0v4h6v18h-6v4h10V0z" style="line-height:normal;font-variant-ligatures:normal;font-variant-position:normal;font-variant-caps:normal;font-variant-numeric:normal;font-variant-alternates:normal;font-feature-settings:normal;text-indent:0;text-align:start;text-decoration-line:none;text-decoration-style:solid;text-decoration-color:#000;text-transform:none;text-orientation:mixed;white-space:normal;shape-padding:0;isolation:auto;mix-blend-mode:normal;solid-color:#000;solid-opacity:1" color="#000" font-family="sans-serif" fill="#201a26"/>
<path word-spacing="0" letter-spacing=".2" font-size="12" font-weight="700" style="line-height:1.25;-inkscape-font-specification:'Heebo Bold';text-align:start" d="M113.498 14.926q-4.5-.96-4.5-3.878 0-1.079.609-1.981.621-.902 1.781-1.441 1.16-.54 2.707-.54 1.63 0 2.848.528 1.219.516 1.875 1.453.656.926.656 2.121h-3.539q0-.762-.457-1.183-.457-.434-1.394-.434-.774 0-1.243.363-.457.364-.457.938 0 .55.516.89.527.34 1.781.575 1.5.28 2.543.738 1.043.445 1.653 1.242.62.797.62 2.027 0 1.114-.667 2.004-.657.88-1.887 1.383-1.219.504-2.836.504-1.711 0-2.965-.621-1.242-.633-1.898-1.617-.645-.985-.645-2.051h3.34q.036.914.656 1.36.621.433 1.594.433.902 0 1.383-.34.492-.351.492-.937 0-.364-.223-.61-.21-.258-.773-.48-.55-.223-1.57-.446zm19.384-7.606l-5.086 14.58q-.293.831-.726 1.523-.434.703-1.266 1.195-.832.504-2.098.504-.457 0-.75-.048-.281-.046-.785-.176v-2.672q.176.02.527.02.95 0 1.418-.293.47-.293.715-.961l.352-.926-4.43-12.738h3.797l2.262 7.687 2.285-7.687zm5.884 7.606q-4.5-.96-4.5-3.878 0-1.079.61-1.981.62-.902 1.781-1.441 1.16-.54 2.707-.54 1.629 0 2.848.528 1.218.516 1.875 1.453.656.926.656 2.121h-3.539q0-.762-.457-1.183-.457-.434-1.395-.434-.773 0-1.242.363-.457.364-.457.938 0 .55.516.89.527.34 1.781.575 1.5.28 2.543.738 1.043.445 1.652 1.242.621.797.621 2.027 0 1.114-.668 2.004-.656.88-1.886 1.383-1.219.504-2.836.504-1.711 0-2.965-.621-1.242-.633-1.899-1.617-.644-.985-.644-2.051h3.34q.036.914.656 1.36.621.433 1.594.433.902 0 1.383-.34.492-.351.492-.937 0-.364-.223-.61-.21-.258-.773-.48-.551-.223-1.57-.446zm13.983 2.403q.574 0 .984-.082v2.66q-.914.328-2.086.328-3.727 0-3.727-3.797V9.899h-1.793V7.321h1.793v-3.14h3.54v3.14h2.132v2.578h-2.133v6.129q0 .75.293 1.031.293.27.997.27zm14.228-2.519h-8.016q.2 1.183.985 1.886.785.691 2.015.691.914 0 1.688-.34.785-.351 1.336-1.042l1.699 1.957q-.668.96-1.957 1.617-1.278.656-3 .656-1.946 0-3.387-.82-1.43-.82-2.203-2.227-.762-1.406-.762-3.105v-.446q0-1.898.715-3.386.715-1.489 2.063-2.32 1.347-.844 3.187-.844 1.793 0 3.059.761 1.265.762 1.922 2.168.656 1.395.656 3.293zm-3.469-2.65q-.024-1.03-.574-1.628-.54-.598-1.617-.598-1.008 0-1.582.668-.563.668-.739 1.84h4.512zm19.923-5.073q1.934 0 2.989 1.148 1.054 1.148 1.054 3.727v8.039h-3.539V11.95q0-.797-.21-1.23-.212-.446-.61-.61-.387-.164-.984-.164-.715 0-1.219.352-.504.34-.797.972.02.082.02.27V20h-3.54v-8.015q0-.797-.21-1.242-.211-.445-.61-.621-.386-.176-.996-.176-.68 0-1.183.304-.492.293-.797.844V20h-3.539V7.32h3.316l.118 1.419q.633-.797 1.547-1.22.926-.433 2.086-.433 1.172 0 2.016.48.855.47 1.312 1.442.633-.926 1.582-1.418.961-.504 2.203-.504zM201.398 2v18h-3.187l-.176-1.359q-1.243 1.594-3.212 1.594-1.535 0-2.66-.82-1.113-.832-1.699-2.285-.574-1.454-.574-3.317v-.246q0-1.934.574-3.398.586-1.465 1.7-2.274 1.124-.808 2.683-.808 1.805 0 3.012 1.37V2.001zm-5.672 15.376q1.488 0 2.133-1.266v-4.898q-.61-1.266-2.11-1.266-1.207 0-1.77.984-.55.985-.55 2.637v.246q0 1.629.54 2.602.55.96 1.757.96z" font-family="Heebo" fill="#201a26"/>
<path d="M45 13L63 3v20z" fill="#30d475"/>
<circle cx="30.001" cy="13.001" r="9" fill="#30d475"/>
</svg>

After

Width:  |  Height:  |  Size: 3.7 KiB

BIN
docs/favicon.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 394 B

10
docs/favicon.svg Normal file
View File

@ -0,0 +1,10 @@
<svg xmlns="http://www.w3.org/2000/svg" width="16" height="16">
<g transform="translate(380 -506.52)">
<rect ry="16.875" rx="16.875" y="2409.281" x="4128.568" height="90" width="90" fill="#201a26" transform="matrix(.17778 0 0 .17778 -1113.968 78.203)" stroke-width="5.625"/>
<g fill="none" stroke="#fff" stroke-width="2">
<path d="M-377 513.02h-1.5v3h1.5M-367 513.02h1.5v3h-1.5" stroke-width="1"/>
</g>
<path d="M-368 516.77v-4.5l-3 1.25-1 1 1 1z" fill="#30d475"/>
<circle cx="-374.25" cy="514.52" r="1.75" fill="#30d475"/>
</g>
</svg>

After

Width:  |  Height:  |  Size: 596 B

BIN
docs/fonts/heebo-bold.woff Normal file

Binary file not shown.

Binary file not shown.

View File

@ -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 by_category = site.pages | group_by:"category" %}
{% assign extra_pages = site.data.extra_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 %} * [{{ page.title }}]({{ page.url | relative_url }}){% endfor %}
{% endif %} {% endif %}
{% endfor %} {% endfor %}

347
docs/style.css Executable file
View File

@ -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);
}