Organized doc md with metadata & draft for doc template
This commit is contained in:
parent
ada5e9ac0e
commit
ee4d6a01e1
51 changed files with 336 additions and 411 deletions
82
config.toml
82
config.toml
|
|
@ -1,133 +1,54 @@
|
||||||
# The base URL of the site; the only required configuration variable.
|
|
||||||
base_url = "https://garagehq.deuxfleurs.fr"
|
base_url = "https://garagehq.deuxfleurs.fr"
|
||||||
|
|
||||||
# The site title and description; used in feeds by default.
|
|
||||||
title = "Garage"
|
title = "Garage"
|
||||||
description = "An open-source distributed storage service you can self-host to fullfill many needs"
|
description = "An open-source distributed storage service you can self-host to fullfill many needs"
|
||||||
|
|
||||||
# The default language; used in feeds.
|
|
||||||
default_language = "en"
|
default_language = "en"
|
||||||
|
|
||||||
# For overriding the default output directory `public`, set it to another value (e.g.: "docs")
|
|
||||||
output_dir = "public"
|
output_dir = "public"
|
||||||
|
|
||||||
# When set to "true", the Sass files in the `sass` directory in the site root are compiled.
|
|
||||||
# Sass files in theme directories are always compiled.
|
|
||||||
compile_sass = true
|
compile_sass = true
|
||||||
|
|
||||||
# When set to "true", the generated HTML files are minified.
|
|
||||||
minify_html = false
|
minify_html = false
|
||||||
|
|
||||||
# A list of glob patterns specifying asset files to ignore when the content
|
|
||||||
# directory is processed. Defaults to none, which means that all asset files are
|
|
||||||
# copied over to the `public` directory.
|
|
||||||
# Example:
|
|
||||||
# ignored_content = ["*.{graphml,xlsx}", "temp.*"]
|
|
||||||
ignored_content = []
|
ignored_content = []
|
||||||
|
|
||||||
# When set to "true", a feed is automatically generated.
|
|
||||||
generate_feed = true
|
generate_feed = true
|
||||||
|
|
||||||
# The filename to use for the feed. Used as the template filename, too.
|
|
||||||
# Defaults to "atom.xml", which has a built-in template that renders an Atom 1.0 feed.
|
|
||||||
# There is also a built-in template "rss.xml" that renders an RSS 2.0 feed.
|
|
||||||
feed_filename = "rss.xml"
|
feed_filename = "rss.xml"
|
||||||
|
|
||||||
# The number of articles to include in the feed. All items are included if
|
|
||||||
# this limit is not set (the default).
|
|
||||||
# feed_limit = 20
|
|
||||||
|
|
||||||
# When set to "true", files in the `static` directory are hard-linked. Useful for large
|
|
||||||
# static files. Note that for this to work, both `static` and the
|
|
||||||
# output directory need to be on the same filesystem. Note that the theme's `static`
|
|
||||||
# files are always copied, regardless of this setting.
|
|
||||||
hard_link_static = false
|
hard_link_static = false
|
||||||
|
|
||||||
# The taxonomies to be rendered for the site and their configuration of the default languages
|
|
||||||
# Example:
|
|
||||||
# taxonomies = [
|
|
||||||
# {name = "tags", feed = true}, # each tag will have its own feed
|
|
||||||
# {name = "tags"}, # you can have taxonomies with the same name in multiple languages
|
|
||||||
# {name = "categories", paginate_by = 5}, # 5 items per page for a term
|
|
||||||
# {name = "authors"}, # Basic definition: no feed or pagination
|
|
||||||
# ]
|
|
||||||
#
|
|
||||||
taxonomies = [
|
taxonomies = [
|
||||||
{ name = "categories", feed = true, paginate_by = 10 },
|
{ name = "categories", feed = true, paginate_by = 10 },
|
||||||
{ name = "tags", feed = true, paginate_by = 10 }
|
{ name = "tags", feed = true, paginate_by = 10 }
|
||||||
]
|
]
|
||||||
|
|
||||||
# When set to "true", a search index is built from the pages and section
|
|
||||||
# content for `default_language`.
|
|
||||||
build_search_index = true
|
build_search_index = true
|
||||||
|
|
||||||
# Configuration of the Markdown rendering
|
|
||||||
[markdown]
|
[markdown]
|
||||||
# When set to "true", all code blocks are highlighted.
|
|
||||||
highlight_code = true
|
highlight_code = true
|
||||||
|
|
||||||
# A list of directories used to search for additional `.sublime-syntax` files.
|
|
||||||
extra_syntaxes = []
|
extra_syntaxes = []
|
||||||
|
|
||||||
# The theme to use for code highlighting.
|
|
||||||
# See below for list of allowed values.
|
|
||||||
highlight_theme = "one-dark"
|
|
||||||
|
|
||||||
# When set to "true", emoji aliases translated to their corresponding
|
|
||||||
# Unicode emoji equivalent in the rendered Markdown files. (e.g.: :smile: => 😄)
|
|
||||||
render_emoji = true
|
render_emoji = true
|
||||||
|
|
||||||
# Whether external links are to be opened in a new tab
|
|
||||||
# If this is true, a `rel="noopener"` will always automatically be added for security reasons
|
|
||||||
external_links_target_blank = true
|
external_links_target_blank = true
|
||||||
|
|
||||||
# Whether to set rel="nofollow" for all external links
|
|
||||||
external_links_no_follow = true
|
external_links_no_follow = true
|
||||||
|
|
||||||
# Whether to set rel="noreferrer" for all external links
|
|
||||||
external_links_no_referrer = true
|
external_links_no_referrer = true
|
||||||
|
|
||||||
# Whether smart punctuation is enabled (changing quotes, dashes, dots in their typographic form)
|
|
||||||
# For example, `...` into `…`, `"quote"` into `“curly”` etc
|
|
||||||
smart_punctuation = false
|
smart_punctuation = false
|
||||||
|
|
||||||
# Configuration of the link checker.
|
|
||||||
[link_checker]
|
[link_checker]
|
||||||
# Skip link checking for external URLs that start with these prefixes
|
|
||||||
skip_prefixes = [
|
skip_prefixes = [
|
||||||
"http://[2001:db8::]/",
|
"http://[2001:db8::]/",
|
||||||
]
|
]
|
||||||
|
|
||||||
# Skip anchor checking for external URLs that start with these prefixes
|
|
||||||
skip_anchor_prefixes = [
|
skip_anchor_prefixes = [
|
||||||
"https://caniuse.com/",
|
"https://caniuse.com/",
|
||||||
]
|
]
|
||||||
|
|
||||||
# Various slugification strategies, see below for details
|
|
||||||
# Defaults to everything being a slug
|
|
||||||
[slugify]
|
[slugify]
|
||||||
paths = "on"
|
paths = "on"
|
||||||
taxonomies = "on"
|
taxonomies = "on"
|
||||||
anchors = "on"
|
anchors = "on"
|
||||||
|
|
||||||
[search]
|
[search]
|
||||||
# Whether to include the title of the page/section in the index
|
|
||||||
include_title = true
|
include_title = true
|
||||||
# Whether to include the description of the page/section in the index
|
|
||||||
include_description = false
|
include_description = false
|
||||||
# Whether to include the path of the page/section in the index
|
|
||||||
include_path = false
|
include_path = false
|
||||||
# Whether to include the rendered content of the page/section in the index
|
|
||||||
include_content = true
|
include_content = true
|
||||||
|
|
||||||
[extra]
|
[extra]
|
||||||
katex.enabled = true
|
katex.enabled = true
|
||||||
katex.auto_render = true
|
katex.auto_render = true
|
||||||
|
|
||||||
chart.enabled = true
|
chart.enabled = true
|
||||||
mermaid.enabled = true
|
mermaid.enabled = true
|
||||||
galleria.enabled = true
|
galleria.enabled = true
|
||||||
|
|
||||||
navbar_items = [
|
navbar_items = [
|
||||||
{ code = "en", nav_items = [
|
{ code = "en", nav_items = [
|
||||||
{ url = "$BASE_URL/", name = "Overview" },
|
{ url = "$BASE_URL/", name = "Overview" },
|
||||||
|
|
@ -159,9 +80,6 @@ email = "contact@garagehq.com"
|
||||||
[extra.analytics]
|
[extra.analytics]
|
||||||
google = "UA-176984489-2"
|
google = "UA-176984489-2"
|
||||||
|
|
||||||
[extra.commenting]
|
|
||||||
disqus = "deepthought-theme"
|
|
||||||
|
|
||||||
[extra.mapbox]
|
[extra.mapbox]
|
||||||
enabled = true
|
enabled = true
|
||||||
access_token = "pk.eyJ1IjoicmF0YW5zaHJlc2h0aGEiLCJhIjoiY2tla2s2NmM3MDd0ZzJzbXFtc3Y2YmU0NyJ9.0RhUnJPKbxHWw3xGPnnBlA"
|
access_token = "pk.eyJ1IjoicmF0YW5zaHJlc2h0aGEiLCJhIjoiY2tla2s2NmM3MDd0ZzJzbXFtc3Y2YmU0NyJ9.0RhUnJPKbxHWw3xGPnnBlA"
|
||||||
|
|
|
||||||
5
content/documentation/_index.md
Normal file
5
content/documentation/_index.md
Normal file
|
|
@ -0,0 +1,5 @@
|
||||||
|
+++
|
||||||
|
template = "documentation.html"
|
||||||
|
page_template = "documentation.html"
|
||||||
|
redirect_to = "documentation/quick-start/"
|
||||||
|
+++
|
||||||
6
content/documentation/connect/_index.md
Normal file
6
content/documentation/connect/_index.md
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
+++
|
||||||
|
title = "Integrations"
|
||||||
|
weight = 3
|
||||||
|
sort_by = "weight"
|
||||||
|
redirect_to = "documentation/connect/apps/"
|
||||||
|
+++
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Apps (Nextcloud, Peertube...)"
|
||||||
date=2018-08-20
|
weight = 5
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Apps (Nextcloud, Peertube...)
|
# Apps (Nextcloud, Peertube...)
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Backups (restic, duplicity...)"
|
||||||
date=2018-08-20
|
weight = 25
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Backups (restic, duplicity...)
|
# Backups (restic, duplicity...)
|
||||||
|
|
|
||||||
Binary file not shown.
|
Before Width: | Height: | Size: 197 KiB |
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "CLI tools"
|
||||||
date=2018-08-20
|
weight = 20
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# CLI tools
|
# CLI tools
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Your code (PHP, JS, Go...)"
|
||||||
date=2018-08-20
|
weight = 30
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Your code (PHP, JS, Go...)
|
# Your code (PHP, JS, Go...)
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "FUSE (s3fs, goofys, s3backer...)"
|
||||||
date=2018-08-20
|
weight = 25
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# FUSE (s3fs, goofys, s3backer...)
|
# FUSE (s3fs, goofys, s3backer...)
|
||||||
|
|
|
||||||
|
|
@ -1,46 +0,0 @@
|
||||||
+++
|
|
||||||
title="Doc Post"
|
|
||||||
date=2018-08-20
|
|
||||||
+++
|
|
||||||
|
|
||||||
# Integrations
|
|
||||||
|
|
||||||
Garage implements the Amazon S3 protocol, which makes it compatible with many existing software programs.
|
|
||||||
|
|
||||||
In particular, you will find here instructions to connect it with:
|
|
||||||
|
|
||||||
- [web applications](./apps.md)
|
|
||||||
- [website hosting](./websites.md)
|
|
||||||
- [software repositories](./repositories.md)
|
|
||||||
- [CLI tools](./cli.md)
|
|
||||||
- [your own code](./code.md)
|
|
||||||
|
|
||||||
### Generic instructions
|
|
||||||
|
|
||||||
To configure S3-compatible software to interact with Garage,
|
|
||||||
you will need the following parameters:
|
|
||||||
|
|
||||||
- An **API endpoint**: this corresponds to the HTTP or HTTPS address
|
|
||||||
used to contact the Garage server. When runing Garage locally this will usually
|
|
||||||
be `http://127.0.0.1:3900`. In a real-world setting, you would usually have a reverse-proxy
|
|
||||||
that adds TLS support and makes your Garage server available under a public hostname
|
|
||||||
such as `https://garage.example.com`.
|
|
||||||
|
|
||||||
- An **API access key** and its associated **secret key**. These usually look something
|
|
||||||
like this: `GK3515373e4c851ebaad366558` (access key),
|
|
||||||
`7d37d093435a41f2aab8f13c19ba067d9776c90215f56614adad6ece597dbb34` (secret key).
|
|
||||||
These keys are created and managed using the `garage` CLI, as explained in the
|
|
||||||
[quick start](../quick_start/index.md) guide.
|
|
||||||
|
|
||||||
Most S3 clients can be configured easily with these parameters,
|
|
||||||
provided that you follow the following guidelines:
|
|
||||||
|
|
||||||
- **Force path style:** Garage does not support DNS-style buckets, which are now by default
|
|
||||||
on Amazon S3. Instead, Garage uses the legacy path-style bucket addressing.
|
|
||||||
Remember to configure your client to acknowledge this fact.
|
|
||||||
|
|
||||||
- **Configuring the S3 region:** Garage requires your client to talk to the correct "S3 region",
|
|
||||||
which is set in the configuration file. This is often set just to `garage`.
|
|
||||||
If this is not configured explicitly, clients usually try to talk to region `us-east-1`.
|
|
||||||
Garage should normally redirect your client to the correct region,
|
|
||||||
but in case your client does not support this you might have to configure it manually.
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Repositories (Docker, Nix, Git...)"
|
||||||
date=2018-08-20
|
weight = 15
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Repositories (Docker, Nix, Git...)
|
# Repositories (Docker, Nix, Git...)
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Websites (Hugo, Jekyll, Publii...)"
|
||||||
date=2018-08-20
|
weight = 10
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Websites (Hugo, Jekyll, Publii...)
|
# Websites (Hugo, Jekyll, Publii...)
|
||||||
|
|
|
||||||
6
content/documentation/cookbook/_index.md
Normal file
6
content/documentation/cookbook/_index.md
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
+++
|
||||||
|
title="Cookbook"
|
||||||
|
weight = 2
|
||||||
|
sort_by = "weight"
|
||||||
|
redirect_to = "documentation/cookbook/real-world/"
|
||||||
|
+++
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Exposing buckets as websites"
|
||||||
date=2018-08-20
|
weight = 25
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Exposing buckets as websites
|
# Exposing buckets as websites
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Compiling Garage from source"
|
||||||
date=2018-08-20
|
weight = 10
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Compiling Garage from source
|
# Compiling Garage from source
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Configuring a gateway node"
|
||||||
date=2018-08-20
|
weight = 20
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Gateways
|
# Gateways
|
||||||
|
|
|
||||||
|
|
@ -1,31 +0,0 @@
|
||||||
+++
|
|
||||||
title="Doc Post"
|
|
||||||
date=2018-08-20
|
|
||||||
+++
|
|
||||||
|
|
||||||
# Cookbook
|
|
||||||
|
|
||||||
A cookbook, when you cook, is a collection of recipes.
|
|
||||||
Similarly, Garage's cookbook contains a collection of recipes that are known to works well!
|
|
||||||
This chapter could also be referred as "Tutorials" or "Best practices".
|
|
||||||
|
|
||||||
- **[Multi-node deployment](real_world.md):** This page will walk you through all of the necessary
|
|
||||||
steps to deploy Garage in a real-world setting.
|
|
||||||
|
|
||||||
- **[Building from source](from_source.md):** This page explains how to build Garage from
|
|
||||||
source in case a binary is not provided for your architecture, or if you want to
|
|
||||||
hack with us!
|
|
||||||
|
|
||||||
- **[Integration with Systemd](systemd.md):** This page explains how to run Garage
|
|
||||||
as a Systemd service (instead of as a Docker container).
|
|
||||||
|
|
||||||
- **[Configuring a gateway node](gateways.md):** This page explains how to run a gateway node in a Garage cluster, i.e. a Garage node that doesn't store data but accelerates access to data present on the other nodes.
|
|
||||||
|
|
||||||
- **[Hosting a website](exposing_websites.md):** This page explains how to use Garage
|
|
||||||
to host a static website.
|
|
||||||
|
|
||||||
- **[Configuring a reverse-proxy](reverse_proxy.md):** This page explains how to configure a reverse-proxy to add TLS support to your S3 api endpoint.
|
|
||||||
|
|
||||||
- **[Recovering from failures](recovering.md):** Garage's first selling point is resilience
|
|
||||||
to hardware failures. This section explains how to recover from such a failure in the
|
|
||||||
best possible way.
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Multi-node deployment"
|
||||||
date=2018-08-20
|
weight = 5
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Deploying Garage on a real-world cluster
|
# Deploying Garage on a real-world cluster
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Recovering from failures"
|
||||||
date=2018-08-20
|
weight = 35
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Recovering from failures
|
# Recovering from failures
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Configuring a reverse proxy"
|
||||||
date=2018-08-20
|
weight = 30
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Configuring a reverse proxy
|
# Configuring a reverse proxy
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Starting Garage with systemd"
|
||||||
date=2018-08-20
|
weight = 15
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Starting Garage with systemd
|
# Starting Garage with systemd
|
||||||
|
|
|
||||||
|
|
@ -1,8 +0,0 @@
|
||||||
+++
|
|
||||||
title="Doc Post"
|
|
||||||
date=2018-08-20
|
|
||||||
+++
|
|
||||||
|
|
||||||
# Hosting a website
|
|
||||||
|
|
||||||
TODO
|
|
||||||
6
content/documentation/design/_index.md
Normal file
6
content/documentation/design/_index.md
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
+++
|
||||||
|
title = "Design"
|
||||||
|
weight = 5
|
||||||
|
sort_by = "weight"
|
||||||
|
redirect_to = "documentation/design/goals/"
|
||||||
|
+++
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Benchmarks"
|
||||||
date=2018-08-20
|
weight = 10
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Benchmarks
|
# Benchmarks
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Goals and use cases"
|
||||||
date=2018-08-20
|
weight = 5
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Goals and use cases
|
# Goals and use cases
|
||||||
|
|
|
||||||
|
|
@ -1,31 +0,0 @@
|
||||||
+++
|
|
||||||
title="Doc Post"
|
|
||||||
date=2018-08-20
|
|
||||||
+++
|
|
||||||
|
|
||||||
# Design
|
|
||||||
|
|
||||||
The design section helps you to see Garage from a "big picture"
|
|
||||||
perspective. It will allow you to understand if Garage is a good fit for
|
|
||||||
you, how to better use it, how to contribute to it, what can Garage could
|
|
||||||
and could not do, etc.
|
|
||||||
|
|
||||||
- **[Goals and use cases](goals.md):** This page explains why Garage was concieved and what practical use cases it targets.
|
|
||||||
|
|
||||||
- **[Related work](related_work.md):** This pages presents the theoretical background on which Garage is built, and describes other software storage solutions and why they didn't work for us.
|
|
||||||
|
|
||||||
- **[Internals](internals.md):** This page enters into more details on how Garage manages data internally.
|
|
||||||
|
|
||||||
## Talks
|
|
||||||
|
|
||||||
We love to talk and hear about Garage, that's why we keep a log here:
|
|
||||||
|
|
||||||
- [(fr, 2021-11-13, video) Garage : Mille et une façons de stocker vos données](https://video.tedomum.net/w/moYKcv198dyMrT8hCS5jz9) and [slides (html)](https://rfid.deuxfleurs.fr/presentations/2021-11-13/garage/) - during [RFID#1](https://rfid.deuxfleurs.fr/programme/2021-11-13/) event
|
|
||||||
|
|
||||||
- [(en, 2021-04-28) Distributed object storage is centralised](https://git.deuxfleurs.fr/Deuxfleurs/garage/raw/commit/b1f60579a13d3c5eba7f74b1775c84639ea9b51a/doc/talks/2021-04-28_spirals-team/talk.pdf)
|
|
||||||
|
|
||||||
- [(fr, 2020-12-02) Garage : jouer dans la cour des grands quand on est un hébergeur associatif](https://git.deuxfleurs.fr/Deuxfleurs/garage/raw/commit/b1f60579a13d3c5eba7f74b1775c84639ea9b51a/doc/talks/2020-12-02_wide-team/talk.pdf)
|
|
||||||
|
|
||||||
*Did you write or talk about Garage? [Open a pull request](https://git.deuxfleurs.fr/Deuxfleurs/garage/) to add a link here!*
|
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Internals"
|
||||||
date=2018-08-20
|
weight = 20
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Internals
|
# Internals
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Related work"
|
||||||
date=2018-08-20
|
weight = 15
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Related work
|
# Related work
|
||||||
|
|
|
||||||
6
content/documentation/development/_index.md
Normal file
6
content/documentation/development/_index.md
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
+++
|
||||||
|
title = "Development"
|
||||||
|
weight = 6
|
||||||
|
sort_by = "weight"
|
||||||
|
redirect_to = "documentation/development/devenv/"
|
||||||
|
+++
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Setup your environment"
|
||||||
date=2018-08-20
|
weight = 5
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Setup your development environment
|
# Setup your development environment
|
||||||
|
|
|
||||||
|
|
@ -1,19 +0,0 @@
|
||||||
+++
|
|
||||||
title="Doc Post"
|
|
||||||
date=2018-08-20
|
|
||||||
+++
|
|
||||||
|
|
||||||
# Development
|
|
||||||
|
|
||||||
Now that you are a Garage expert, you want to enhance it, you are in the right place!
|
|
||||||
We discuss here how to hack on Garage, how we manage its development, etc.
|
|
||||||
|
|
||||||
## Rust API (docs.rs)
|
|
||||||
If you encounter a specific bug in Garage or plan to patch it, you may jump directly to the source code's documentation!
|
|
||||||
|
|
||||||
- [garage\_api](https://docs.rs/garage_api/latest/garage_api/) - contains the S3 standard API endpoint
|
|
||||||
- [garage\_model](https://docs.rs/garage_model/latest/garage_model/) - contains Garage's model built on the table abstraction
|
|
||||||
- [garage\_rpc](https://docs.rs/garage_rpc/latest/garage_rpc/) - contains Garage's federation protocol
|
|
||||||
- [garage\_table](https://docs.rs/garage_table/latest/garage_table/) - contains core Garage's CRDT datatypes
|
|
||||||
- [garage\_util](https://docs.rs/garage_util/latest/garage_util/) - contains garage helpers
|
|
||||||
- [garage\_web](https://docs.rs/garage_web/latest/garage_web/) - contains the S3 website endpoint
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Miscellaneous notes"
|
||||||
date=2018-08-20
|
weight = 20
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Miscellaneous Notes
|
# Miscellaneous Notes
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Release process"
|
||||||
date=2018-08-20
|
weight = 15
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Release process
|
# Release process
|
||||||
|
|
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Development scripts"
|
||||||
date=2018-08-20
|
weight = 10
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Development scripts
|
# Development scripts
|
||||||
|
|
|
||||||
|
|
@ -1,106 +0,0 @@
|
||||||
+++
|
|
||||||
title="Doc Post"
|
|
||||||
date=2018-08-20
|
|
||||||
+++
|
|
||||||
|
|
||||||
<p align="center" style="text-align:center;">
|
|
||||||
<a href="https://garagehq.deuxfleurs.fr">
|
|
||||||
<img alt="Garage's Logo" src="img/logo.svg" height="200" />
|
|
||||||
</a>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p align="center" style="text-align:center;">
|
|
||||||
[ <a href="https://garagehq.deuxfleurs.fr/_releases.html">Download</a>
|
|
||||||
| <a href="https://git.deuxfleurs.fr/Deuxfleurs/garage">Git repository</a>
|
|
||||||
| <a href="https://matrix.to/#/%23garage:deuxfleurs.fr">Matrix channel</a>
|
|
||||||
| <a href="https://drone.deuxfleurs.fr/Deuxfleurs/garage">Drone CI</a>
|
|
||||||
]
|
|
||||||
</p>
|
|
||||||
|
|
||||||
|
|
||||||
# Data resiliency for everyone
|
|
||||||
|
|
||||||
Garage is an **open-source** distributed **storage service** you can **self-host** to fullfill many needs:
|
|
||||||
|
|
||||||
<p align="center" style="text-align:center; margin-bottom: 5rem;">
|
|
||||||
<img alt="Summary of the possible usages with a related icon: host a website, store media and backup target" src="img/usage.svg" />
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p align="center" style="text-align:center; margin-bottom: 5rem;">
|
|
||||||
<a href="/design/goals.html#use-cases">⮞ learn more about use cases ⮜</a>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
Garage implements the **[Amazon S3 API](https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html)** and thus is already **compatible** with many applications:
|
|
||||||
|
|
||||||
<p align="center" style="text-align:center; margin-bottom: 8rem;">
|
|
||||||
<img alt="Garage is already compatible with Nextcloud, Mastodon, Matrix Synapse, Cyberduck, RClone and Peertube" src="img/software.svg" />
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p align="center" style="text-align:center; margin-bottom: 5rem;">
|
|
||||||
<a href="/connect/index.html">⮞ learn more about integrations ⮜</a>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
|
|
||||||
Garage provides **data resiliency** by **replicating** data 3x over **distant** servers:
|
|
||||||
|
|
||||||
<p align="center" style="text-align:center; margin-bottom: 5rem;">
|
|
||||||
<img alt="An example deployment on a map with servers in 5 zones: UK, France, Belgium, Germany and Switzerland. Each chunk of data is replicated in 3 of these 5 zones." src="img/map.svg" />
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p align="center" style="text-align:center; margin-bottom: 5rem;">
|
|
||||||
<a href="/design/index.html">⮞ learn more about our design ⮜</a>
|
|
||||||
</p>
|
|
||||||
|
|
||||||
Did you notice that *this website* is hosted and served by Garage?
|
|
||||||
|
|
||||||
## Keeping requirements low
|
|
||||||
|
|
||||||
We worked hard to keep requirements as low as possible as we target the largest possible public.
|
|
||||||
|
|
||||||
* **CPU:** any x86\_64 CPU from the last 10 years, ARMv7 or ARMv8.
|
|
||||||
* **RAM:** 1GB
|
|
||||||
* **Disk Space:** at least 16GB
|
|
||||||
* **Network:** 200ms or less, 50 Mbps or more
|
|
||||||
* **Heterogeneous hardware:** build a cluster with whatever second-hand machines are available
|
|
||||||
|
|
||||||
*For the network, as we do not use consensus algorithms like Paxos or Raft, Garage is not as latency sensitive.*
|
|
||||||
*Thanks to Rust and its zero-cost abstractions, we keep CPU and memory low.*
|
|
||||||
|
|
||||||
## Built on the shoulder of giants
|
|
||||||
|
|
||||||
- [Dynamo: Amazon’s Highly Available Key-value Store ](https://dl.acm.org/doi/abs/10.1145/1323293.1294281) by DeCandia et al.
|
|
||||||
- [Conflict-Free Replicated Data Types](https://link.springer.com/chapter/10.1007/978-3-642-24550-3_29) by Shapiro et al.
|
|
||||||
- [Maglev: A Fast and Reliable Software Network Load Balancer](https://www.usenix.org/conference/nsdi16/technical-sessions/presentation/eisenbud) by Eisenbud et al.
|
|
||||||
|
|
||||||
## Talks
|
|
||||||
|
|
||||||
- [(fr, 2021-11-13, video) Garage : Mille et une façons de stocker vos données](https://video.tedomum.net/w/moYKcv198dyMrT8hCS5jz9) and [slides (html)](https://rfid.deuxfleurs.fr/presentations/2021-11-13/garage/) - during [RFID#1](https://rfid.deuxfleurs.fr/programme/2021-11-13/) event
|
|
||||||
|
|
||||||
- [(en, 2021-04-28, pdf) Distributed object storage is centralised](https://git.deuxfleurs.fr/Deuxfleurs/garage/raw/commit/b1f60579a13d3c5eba7f74b1775c84639ea9b51a/doc/talks/2021-04-28_spirals-team/talk.pdf)
|
|
||||||
|
|
||||||
- [(fr, 2020-12-02, pdf) Garage : jouer dans la cour des grands quand on est un hébergeur associatif](https://git.deuxfleurs.fr/Deuxfleurs/garage/raw/commit/b1f60579a13d3c5eba7f74b1775c84639ea9b51a/doc/talks/2020-12-02_wide-team/talk.pdf)
|
|
||||||
|
|
||||||
## Community
|
|
||||||
|
|
||||||
If you want to discuss with us, you can join our Matrix channel at [#garage:deuxfleurs.fr](https://matrix.to/#/#garage:deuxfleurs.fr).
|
|
||||||
Our code repository and issue tracker, which is the place where you should report bugs, is managed on [Deuxfleurs' Gitea](https://git.deuxfleurs.fr/Deuxfleurs/garage).
|
|
||||||
|
|
||||||
## License
|
|
||||||
|
|
||||||
Garage's source code, is released under the [AGPL v3 License](https://www.gnu.org/licenses/agpl-3.0.en.html).
|
|
||||||
Please note that if you patch Garage and then use it to provide any service over a network, you must share your code!
|
|
||||||
|
|
||||||
# Sponsors and funding
|
|
||||||
|
|
||||||
The Deuxfleurs association has received a grant from [NGI POINTER](https://pointer.ngi.eu/), to fund 3 people working on Garage full-time for a year: from October 2021 to September 2022.
|
|
||||||
|
|
||||||
<div style="display: flex; justify-content: space-around">
|
|
||||||
<a href="https://pointer.ngi.eu/">
|
|
||||||
<img style="height:100px" src="img/ngi-logo.png" alt="NGI Pointer logo">
|
|
||||||
</a>
|
|
||||||
<a href="https://ec.europa.eu/programmes/horizon2020/what-horizon-2020">
|
|
||||||
<img style="height:100px" src="img/eu-flag-logo.png" alt="EU flag logo">
|
|
||||||
</a>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
_This project has received funding from the European Union’s Horizon 2020 research and innovation programme within the framework of the NGI-POINTER Project funded under grant agreement N° 871528._
|
|
||||||
6
content/documentation/quick-start/_index.md
Normal file
6
content/documentation/quick-start/_index.md
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
+++
|
||||||
|
title = "Quick Start"
|
||||||
|
weight = 1
|
||||||
|
sort_by = "weight"
|
||||||
|
redirect_to = "documentation/quick-start/overview/"
|
||||||
|
+++
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Overview"
|
||||||
date=2018-08-20
|
weight = 5
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Quick Start
|
# Quick Start
|
||||||
|
|
@ -73,7 +73,7 @@ Garage server will not be persistent. Change these to locations on your local di
|
||||||
your data to be persisted properly.
|
your data to be persisted properly.
|
||||||
|
|
||||||
|
|
||||||
## Launching the Garage server
|
# Launching the Garage server
|
||||||
|
|
||||||
Use the following command to launch the Garage server with our configuration file:
|
Use the following command to launch the Garage server with our configuration file:
|
||||||
|
|
||||||
6
content/documentation/reference-manual/_index.md
Normal file
6
content/documentation/reference-manual/_index.md
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
+++
|
||||||
|
title = "Reference Manual"
|
||||||
|
weight = 4
|
||||||
|
sort_by = "weight"
|
||||||
|
redirect_to = "documentation/reference-manual/configuration/"
|
||||||
|
+++
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Garage CLI"
|
||||||
date=2018-08-20
|
weight = 15
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Garage CLI
|
# Garage CLI
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Garage configuration file"
|
||||||
date=2018-08-20
|
weight = 5
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Garage configuration file format reference
|
# Garage configuration file format reference
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Cluster layout management"
|
||||||
date=2018-08-20
|
weight = 10
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Creating and updating a cluster layout
|
# Creating and updating a cluster layout
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "S3 Compatibility status"
|
||||||
date=2018-08-20
|
weight = 20
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# S3 Compatibility status
|
# S3 Compatibility status
|
||||||
|
|
@ -1,10 +0,0 @@
|
||||||
+++
|
|
||||||
title="Doc Post"
|
|
||||||
date=2018-08-20
|
|
||||||
+++
|
|
||||||
|
|
||||||
# Reference Manual
|
|
||||||
|
|
||||||
A reference manual contains some extensive descriptions about the features and the behaviour of the software.
|
|
||||||
Reading of this chapter is recommended once you have a good knowledge/understanding of Garage.
|
|
||||||
It will be useful if you want to tune it or to use it in some exotic conditions.
|
|
||||||
6
content/documentation/working-documents/_index.md
Normal file
6
content/documentation/working-documents/_index.md
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
+++
|
||||||
|
title = "Working Documents"
|
||||||
|
weight = 7
|
||||||
|
sort_by = "weight"
|
||||||
|
redirect_to = "documentation/working-documents/compatibility-target/"
|
||||||
|
+++
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "S3 compatibility target"
|
||||||
date=2018-08-20
|
weight = 5
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# S3 compatibility target
|
# S3 compatibility target
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Design draft"
|
||||||
date=2018-08-20
|
weight = 25
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Design draft
|
# Design draft
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Load balancing data"
|
||||||
date=2018-08-20
|
weight = 10
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Load Balancing Data (planned for version 0.2)
|
# Load Balancing Data (planned for version 0.2)
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Migrating from 0.3 to 0.4"
|
||||||
date=2018-08-20
|
weight = 20
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Migrating from 0.3 to 0.4
|
# Migrating from 0.3 to 0.4
|
||||||
|
|
@ -1,6 +1,6 @@
|
||||||
+++
|
+++
|
||||||
title="Doc Post"
|
title = "Migrating from 0.5 to 0.6"
|
||||||
date=2018-08-20
|
weight = 15
|
||||||
+++
|
+++
|
||||||
|
|
||||||
# Migrating from 0.5 to 0.6
|
# Migrating from 0.5 to 0.6
|
||||||
|
|
@ -1,13 +0,0 @@
|
||||||
+++
|
|
||||||
title="Doc Post"
|
|
||||||
date=2018-08-20
|
|
||||||
+++
|
|
||||||
|
|
||||||
# Working Documents
|
|
||||||
|
|
||||||
Working documents are documents that reflect the fact that Garage is a software that evolves quickly.
|
|
||||||
They are a way to communicate our ideas, our changes, and so on before or while we are implementing them in Garage.
|
|
||||||
If you like to live on the edge, it could also serve as a documentation of our next features to be released.
|
|
||||||
|
|
||||||
Ideally, once the feature/patch has been merged, the working document should serve as a source to
|
|
||||||
update the rest of the documentation and then be removed.
|
|
||||||
224
templates/documentation.html
Normal file
224
templates/documentation.html
Normal file
|
|
@ -0,0 +1,224 @@
|
||||||
|
{% extends 'base.html' %}
|
||||||
|
|
||||||
|
{% block title %}
|
||||||
|
{{ config.title }} | {{ page.title }}
|
||||||
|
{% endblock %}
|
||||||
|
|
||||||
|
{% block content %}
|
||||||
|
{% set section = get_section(path="documentation/_index.md") %}
|
||||||
|
<section class="section overflow-x-hidden">
|
||||||
|
<div class="grid grid-cols-5">
|
||||||
|
|
||||||
|
<aside class="col-span-1 h-full bg-gray-100 shadow-inner border-r border-t border-gray-200">
|
||||||
|
{% if section.toc %}
|
||||||
|
<ul>
|
||||||
|
{% for h1 in section.toc %}
|
||||||
|
<li>
|
||||||
|
<a href="{{ h1.permalink | safe }}">{{ h1.title }}</a>
|
||||||
|
{% if h1.children %}
|
||||||
|
<ul>
|
||||||
|
{% for h2 in h1.children %}
|
||||||
|
<li>
|
||||||
|
<a href="{{ h2.permalink | safe }}">{{ h2.title }}</a>
|
||||||
|
</li>
|
||||||
|
{% endfor %}
|
||||||
|
</ul>
|
||||||
|
{% endif %}
|
||||||
|
</li>
|
||||||
|
{% endfor %}
|
||||||
|
</ul>
|
||||||
|
{% endif %}
|
||||||
|
</aside>
|
||||||
|
|
||||||
|
<div class="col-span-3">
|
||||||
|
<article class="box my-12 px-12">
|
||||||
|
<div class="flex flex-col bg-gray-100 rounded-r shadow-sm w-max">
|
||||||
|
<div class="flex flex-col border-l-4 border-garage-orange py-2 px-4 relative">
|
||||||
|
<h1 class="title leading-10 text-3xl text-garage-orange font-semibold">
|
||||||
|
{{ page.title }}
|
||||||
|
</h1>
|
||||||
|
{% if page.description %}
|
||||||
|
<p class="subtitle my-2 text-gray-600 italic text-sm">{{ page.description }}</p>
|
||||||
|
{% endif %}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div class="page-content max-w-4xl">
|
||||||
|
{{ page.content | safe }}
|
||||||
|
</div>
|
||||||
|
</article>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<aside class="hidden 2xl:block fixed right-0 bottom-1/2 transform translate-y-1/2 col-span-1 h-auto bg-gray-100 rounded-l-lg shadow-inner">
|
||||||
|
{% if page.toc %}
|
||||||
|
<div class="w-full flex items-center justify-center py-1.5 bg-gray-200 rounded-tl-lg">
|
||||||
|
<span class="uppercase tracking-wide text-xs text-garage-gray">Page content</span>
|
||||||
|
</div>
|
||||||
|
<ol class="text-sm space-y-0.5 py-0.5 px-8 py-3 list-decimal">
|
||||||
|
{% for h1 in page.toc %}
|
||||||
|
<li>
|
||||||
|
<a href="{{ h1.permalink | safe }}" class="font-semibold bg-gradient-to-r from-garage-gray to-garage-orange text-transparent bg-clip-text transition-all hover:text-garage-orange">{{ h1.title }}</a>
|
||||||
|
{% if h1.children %}
|
||||||
|
<ul class="space-y-0.5 py-0.5">
|
||||||
|
{% for h2 in h1.children %}
|
||||||
|
<li>
|
||||||
|
<a href="{{ h2.permalink | safe }}" class="text-gray-700 hover:text-garage-orange">{{ h2.title }}</a>
|
||||||
|
</li>
|
||||||
|
{% endfor %}
|
||||||
|
</ul>
|
||||||
|
{% endif %}
|
||||||
|
</li>
|
||||||
|
{% endfor %}
|
||||||
|
</ol>
|
||||||
|
{% endif %}
|
||||||
|
</aside>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
{% endblock %}
|
||||||
|
|
||||||
|
{% block pagination %}
|
||||||
|
{% if page.earlier or page.later or page.lighter or page.heavier %}
|
||||||
|
<section class="w-full">
|
||||||
|
<div class="container py-20">
|
||||||
|
<div class="mx-auto max-w-4xl">
|
||||||
|
<div class="column is-8">
|
||||||
|
<nav class="flex space-x-8 items-center justify-center">
|
||||||
|
{% if page.later %}
|
||||||
|
<div>
|
||||||
|
<a class="flex items-center space-x-1 hover:text-garage-orange font-semibold text-gray-800"
|
||||||
|
href="{{ page.later.permalink }}">
|
||||||
|
<span class="icon mr-2">
|
||||||
|
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24"
|
||||||
|
xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
||||||
|
d="M7 16l-4-4m0 0l4-4m-4 4h18"></path>
|
||||||
|
</svg>
|
||||||
|
</span>
|
||||||
|
<span>{{ page.later.title }}</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
{% endif %} {% if page.earlier %}
|
||||||
|
<div>
|
||||||
|
<a class="flex items-center space-x-1 hover:text-garage-orange font-semibold text-gray-800"
|
||||||
|
href="{{ page.earlier.permalink }}">
|
||||||
|
{{ page.earlier.title }}<span class="icon ml-2">
|
||||||
|
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24"
|
||||||
|
xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
||||||
|
d="M17 8l4 4m0 0l-4 4m4-4H3"></path>
|
||||||
|
</svg>
|
||||||
|
</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
{% endif %} {% if page.heavier %}
|
||||||
|
<div>
|
||||||
|
<a class="flex items-center space-x-1 hover:text-garage-orange font-semibold text-gray-800"
|
||||||
|
href="{{ page.heavier.permalink }}">
|
||||||
|
<span class="icon mr-2">
|
||||||
|
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24"
|
||||||
|
xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
||||||
|
d="M7 16l-4-4m0 0l4-4m-4 4h18"></path>
|
||||||
|
</svg>
|
||||||
|
</span>
|
||||||
|
<span>{{ page.heavier.title }}</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
{% endif %} {% if page.lighter %}
|
||||||
|
<div>
|
||||||
|
<a class="flex items-center space-x-1 hover:text-garage-orange font-semibold text-gray-800"
|
||||||
|
href="{{ page.lighter.permalink }}">
|
||||||
|
{{ page.lighter.title }}<span class="icon ml-2">
|
||||||
|
<svg class="w-6 h-6" fill="none" stroke="currentColor" viewBox="0 0 24 24"
|
||||||
|
xmlns="http://www.w3.org/2000/svg">
|
||||||
|
<path stroke-linecap="round" stroke-linejoin="round" stroke-width="2"
|
||||||
|
d="M17 8l4 4m0 0l-4 4m4-4H3"></path>
|
||||||
|
</svg>
|
||||||
|
</span>
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
{% endif %}
|
||||||
|
</nav>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
{% endif %}
|
||||||
|
{% endblock %}
|
||||||
|
|
||||||
|
{% block comment %}
|
||||||
|
{% if page.extra.comments and config.extra.commenting.disqus %}
|
||||||
|
<section class="section">
|
||||||
|
<div class="container">
|
||||||
|
<div class="columns is-centered">
|
||||||
|
<div class="column is-6">
|
||||||
|
<div id="disqus_thread"></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
{% endif %}
|
||||||
|
{% endblock %}
|
||||||
|
|
||||||
|
{% block custom_js %}
|
||||||
|
{% if page.extra.toc %}
|
||||||
|
<script type="text/javascript">
|
||||||
|
const menuBarHeight = document.querySelector("nav.navbar").clientHeight;
|
||||||
|
const tocItems = document.querySelectorAll(".toc");
|
||||||
|
const navSections = new Array(tocItems.length);
|
||||||
|
|
||||||
|
tocItems.forEach((el, i) => {
|
||||||
|
let id = el.getAttribute("id").substring(5);
|
||||||
|
navSections[i] = document.getElementById(id);
|
||||||
|
})
|
||||||
|
|
||||||
|
function isVisible(tocIndex) {
|
||||||
|
const current = navSections[tocIndex];
|
||||||
|
const next = tocIndex < tocItems.length - 1 ? navSections[tocIndex + 1]
|
||||||
|
: document.querySelectorAll("section.section").item(1);
|
||||||
|
|
||||||
|
const c = current.getBoundingClientRect();
|
||||||
|
const n = next.getBoundingClientRect();
|
||||||
|
const h = (window.innerHeight || document.documentElement.clientHeight);
|
||||||
|
|
||||||
|
return (c.top <= h) && (n.top - menuBarHeight >= 0);
|
||||||
|
}
|
||||||
|
|
||||||
|
function activateIfVisible() {
|
||||||
|
for (b = true, i = 0; i < tocItems.length; i++) {
|
||||||
|
if (b && isVisible(i)) {
|
||||||
|
tocItems[i].classList.add('is-active');
|
||||||
|
b = false;
|
||||||
|
} else
|
||||||
|
tocItems[i].classList.remove('is-active');
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
var isTicking = null;
|
||||||
|
window.addEventListener('scroll', () => {
|
||||||
|
if (!isTicking) {
|
||||||
|
window.requestAnimationFrame(() => {
|
||||||
|
activateIfVisible();
|
||||||
|
isTicking = false;
|
||||||
|
});
|
||||||
|
isTicking = true;
|
||||||
|
}
|
||||||
|
}, false);
|
||||||
|
</script>
|
||||||
|
{% endif %}
|
||||||
|
|
||||||
|
{% if page.extra.comments and config.extra.commenting.disqus %}
|
||||||
|
<script>
|
||||||
|
var disqus_config = function () {
|
||||||
|
this.page.url = "{{config.base_url | safe}}";
|
||||||
|
this.page.identifier = "{{ current_path | safe}}";
|
||||||
|
};
|
||||||
|
|
||||||
|
(function () {
|
||||||
|
var d = document, s = d.createElement('script');
|
||||||
|
s.src = 'https://{{ config.extra.commenting.disqus | safe}}.disqus.com/embed.js';
|
||||||
|
s.setAttribute('data-timestamp', +new Date());
|
||||||
|
(d.head || d.body).appendChild(s);
|
||||||
|
})();
|
||||||
|
</script>
|
||||||
|
{% endif %}
|
||||||
|
{% endblock %}
|
||||||
Loading…
Reference in a new issue