Browse Source

Merge branch 'pull-upstream' of charlesreid1/mkdocs-material into master

master
Charles Reid Gitea 1 year ago
parent
commit
b0c6890853
53 changed files with 12661 additions and 8636 deletions
  1. +54
    -0
      CHANGELOG
  2. +2
    -2
      CONTRIBUTING.md
  3. +1
    -1
      Dockerfile
  4. +2
    -0
      MANIFEST.in
  5. +47
    -0
      docs/compliance.md
  6. +0
    -1
      docs/contributing.md
  7. +82
    -0
      docs/contributing.md
  8. +4
    -4
      docs/customization.md
  9. +82
    -2
      docs/extensions/codehilite.md
  10. +7
    -4
      docs/extensions/pymdown.md
  11. +26
    -17
      docs/getting-started.md
  12. +2
    -2
      docs/index.md
  13. +79
    -0
      docs/release-notes.md
  14. +4
    -4
      docs/specimen.md
  15. +4
    -0
      material/assets/fonts/font-awesome.css
  16. +13
    -0
      material/assets/fonts/material-icons.css
  17. BIN
      material/assets/fonts/specimen/FontAwesome.ttf
  18. BIN
      material/assets/fonts/specimen/FontAwesome.woff
  19. BIN
      material/assets/fonts/specimen/FontAwesome.woff2
  20. BIN
      material/assets/fonts/specimen/MaterialIcons-Regular.ttf
  21. BIN
      material/assets/fonts/specimen/MaterialIcons-Regular.woff
  22. BIN
      material/assets/fonts/specimen/MaterialIcons-Regular.woff2
  23. +1
    -1
      material/assets/images/icons/bitbucket.1b09e088.svg
  24. +1
    -1
      material/assets/images/icons/github.f0b8504a.svg
  25. +1
    -1
      material/assets/images/icons/gitlab.6dd19c00.svg
  26. +0
    -1
      material/assets/javascripts/application.0cf9b500.js
  27. +1
    -0
      material/assets/javascripts/application.e72fd936.js
  28. +1176
    -0
      material/assets/stylesheets/application-palette.22915126.css
  29. +0
    -2
      material/assets/stylesheets/application-palette.6079476c.css
  30. +2552
    -0
      material/assets/stylesheets/application.451f80e5.css
  31. +0
    -2
      material/assets/stylesheets/application.8d40d89b.css
  32. +30
    -23
      material/base.html
  33. +3
    -3
      material/partials/footer.html
  34. +4
    -6
      material/partials/header.html
  35. +20
    -0
      material/partials/language/cs.html
  36. +19
    -0
      material/partials/language/fi.html
  37. +22
    -0
      material/partials/language/hi.html
  38. +20
    -0
      material/partials/language/sh.html
  39. +19
    -0
      material/partials/language/sk.html
  40. +22
    -0
      material/partials/language/sr.html
  41. +4
    -4
      material/partials/nav-item.html
  42. +4
    -6
      material/partials/nav.html
  43. +39
    -0
      material/partials/palette.html
  44. +2
    -2
      material/partials/search.html
  45. +1
    -2
      material/partials/social.html
  46. +1
    -1
      material/partials/source.html
  47. +5
    -5
      material/partials/tabs-item.html
  48. +1
    -1
      material/partials/toc.html
  49. +2
    -1
      mkdocs.yml
  50. +8276
    -8524
      package-lock.json
  51. +8
    -7
      package.json
  52. +2
    -5
      requirements.txt
  53. +16
    -1
      webpack.config.js

+ 54
- 0
CHANGELOG View File

@@ -1,3 +1,57 @@
mkdocs-material-3.0.3 (2018-08-07)

* Fixed #841: Additional path levels for extra CSS and JS

mkdocs-material-3.0.2 (2018-08-06)

* Fixed #839: Lunr.js stemmer imports incorrect

mkdocs-material-3.0.1 (2018-08-05)

* Fixed #838: Search result links incorrect

mkdocs-material-3.0.0 (2018-08-05)

* Upgraded MkDocs to 1.0
* Upgraded Python in official Docker image to 3.6
* Added Serbian and Serbo-Croatian translations

mkdocs-material-2.9.4 (2018-07-29)

* Fixed build error after MkDocs upgrade

mkdocs-material-2.9.3 (2018-07-29)

* Added link to home for logo in drawer
* Fixed dependency problems between MkDocs and Tornado

mkdocs-material-2.9.2 (2018-06-29)

* Added Hindi and Czech translations

mkdocs-material-2.9.1 (2018-06-18)

* Added support for different spellings for theme color
* Fixed #799: Added support for web font minification in production
* Fixed #800: Added .highlighttable as an alias for .codehilitetable

mkdocs-material-2.9.0 (2018-06-13)

* Added support for theme color on Android
* Fixed #796: Rendering of nested tabbed code blocks

mkdocs-material-2.8.0 (2018-06-10)

* Added support for grouping code blocks with tabs
* Added Material and FontAwesome icon fonts to distribution files (GDPR)
* Added note on compliance with GDPR
* Added Slovak translations
* Fixed #790: Prefixed id attributes with "__" to avoid name clashes

mkdocs-material-2.7.3 (2018-04-26)

* Added Finnish translations

mkdocs-material-2.7.2 (2018-04-09)

* Fixed rendering issue for details on Edge

+ 2
- 2
CONTRIBUTING.md View File

@@ -78,5 +78,5 @@ go ahead.
After your PR is merged, you can safely delete your branch and pull the changes
from the main (upstream) repository.

[4]: http://squidfunk.github.io/mkdocs-material/customization/#environment-setup
[5]: http://squidfunk.github.io/mkdocs-material/customization/#build-process
[4]: https://squidfunk.github.io/mkdocs-material/customization/#environment-setup
[5]: https://squidfunk.github.io/mkdocs-material/customization/#build-process

+ 1
- 1
Dockerfile View File

@@ -18,7 +18,7 @@
# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
# IN THE SOFTWARE.

FROM jfloff/alpine-python:2.7-slim
FROM jfloff/alpine-python:3.6-slim
MAINTAINER Martin Donath <martin.donath@squidfunk.com>

# Set build directory

+ 2
- 0
MANIFEST.in View File

@@ -1,5 +1,7 @@
recursive-include material *.js *.css *.html *.svg *.png *.yml
recursive-include material *.ttf *.woff *.woff2
recursive-exclude site *
recursive-exclude src *
recursive-exclude * __pycache__
recursive-exclude * *.py[co]
include LICENSE

+ 47
- 0
docs/compliance.md View File

@@ -0,0 +1,47 @@
# Compliance with GDPR

## Material does not process any personal data

Material is a theme for MkDocs, a static site generator. In itself, Material
does not perform any tracking or processing of personal data. However, some of
the third-party services that Material integrates with may actually be in breach
with the [General Data Protection Regulation][1] (GDPR) and need to be evaluated
carefully.

[1]: https://en.wikipedia.org/wiki/General_Data_Protection_Regulation

## Third-party services

### Google Fonts

Material makes fonts [easily configurable][2] by relying on Google Fonts CDN.
However, embedding fonts from Google is currently within a gray area as there's
no official statement or ruling regarding GDPR compliance and the topic is still
[actively discussed][3]. For this reason, if you need to ensure GDPR compiance,
you should disable the usage of the Google Font CDN with:

``` yaml
theme:
font: false
```

When Google Fonts are disabled, Material will default to **Helvetica Neue** and
**Monaco** with their corresponding fall backs, relying on system fonts. You
could however include your own, self-hosted webfont by [overriding][4] the
`fonts` block.

The icon fonts (Material and FontAwesome) are bundled with the theme, and thus
self-hosted so there's no third-party involved.

[2]: getting-started.md#font-family
[3]: https://github.com/google/fonts/issues/1495
[4]: customization.md/#overriding-template-blocks

### Google Analytics and Disqus

Material comes with [Google Analytics][4] and [Disqus][5] integrations that need
to be *enabled explicitly*. Disable both integrations in order to be in
compliance with the GDPR.

[5]: getting-started.md#google-analytics
[6]: getting-started.md#disqus

+ 0
- 1
docs/contributing.md View File

@@ -1 +0,0 @@
../CONTRIBUTING.md

+ 82
- 0
docs/contributing.md View File

@@ -0,0 +1,82 @@
# Contributing

Interested in contributing to the Material theme? Want to report a bug? Before
you do, please read the following guidelines.

## Submission context

### Got a question or problem?

For quick questions there's no need to open an issue as you can reach us on
[gitter.im][1].

[1]: https://gitter.im/squidfunk/mkdocs-material

### Found a bug?

If you found a bug in the source code, you can help us by submitting an issue
to the [issue tracker][2] in our GitHub repository. Even better, you can submit
a Pull Request with a fix. However, before doing so, please read the
[submission guidelines][3].

[2]: https://github.com/squidfunk/mkdocs-material/issues
[3]: #submission-guidelines

### Missing a feature?

You can request a new feature by submitting an issue to our GitHub Repository.
If you would like to implement a new feature, please submit an issue with a
proposal for your work first, to be sure that it is of use for everyone, as
the Material theme is highly opinionated. Please consider what kind of change
it is:

* For a **major feature**, first open an issue and outline your proposal so
that it can be discussed. This will also allow us to better coordinate our
efforts, prevent duplication of work, and help you to craft the change so
that it is successfully accepted into the project.

* **Small features and bugs** can be crafted and directly submitted as a Pull
Request. However, there is no guarantee that your feature will make it into
the master, as it's always a matter of opinion whether if benefits the
overall functionality of the theme.

## Submission guidelines

### Submitting an issue

Before you submit an issue, please search the issue tracker, maybe an issue for
your problem already exists and the discussion might inform you of workarounds
readily available.

We want to fix all the issues as soon as possible, but before fixing a bug we
need to reproduce and confirm it. In order to reproduce bugs we will
systematically ask you to provide a minimal reproduction scenario using the
custom issue template. Please stick to the issue template.

Unfortunately we are not able to investigate / fix bugs without a minimal
reproduction scenario, so if we don't hear back from you we may close the issue.

### Submitting a Pull Request (PR)

Search GitHub for an open or closed PR that relates to your submission. You
don't want to duplicate effort. If you do not find a related issue or PR,
go ahead.

1. **Development**: Fork the project, set up the [development environment][4],
make your changes in a separate git branch and add descriptive messages to
your commits.

2. **Build**: Before submitting a pull requests, [build the theme][5]. This is
a mandatory requirement for your PR to get accepted, as the theme should at
all times be installable through GitHub.

3. **Pull Request**: After building the theme, commit the compiled output, push
your branch to GitHub and send a PR to `mkdocs-material:master`. If we
suggest changes, make the required updates, rebase your branch and push the
changes to your GitHub repository, which will automatically update your PR.

After your PR is merged, you can safely delete your branch and pull the changes
from the main (upstream) repository.

[4]: https://squidfunk.github.io/mkdocs-material/customization/#environment-setup
[5]: https://squidfunk.github.io/mkdocs-material/customization/#build-process

+ 4
- 4
docs/customization.md View File

@@ -13,7 +13,7 @@ necessary to preserve the desired style.
few tweaks to an existing theme, you can just add your stylesheets and
JavaScript files to the `docs` directory.

[1]: http://www.mkdocs.org
[1]: https://www.mkdocs.org

### Additional stylesheets

@@ -57,7 +57,7 @@ extra_javascript:

Further assistance can be found in the [MkDocs documentation][2].

[2]: http://www.mkdocs.org/user-guide/styling-your-docs/#customizing-a-theme
[2]: https://www.mkdocs.org/user-guide/styling-your-docs/#customizing-a-theme

## Extending the theme

@@ -66,7 +66,7 @@ extend the theme. From version 0.16 on MkDocs implements [theme extension][3],
an easy way to override parts of a theme without forking and changing the
main theme.

[3]: http://www.mkdocs.org/user-guide/styling-your-docs/#using-the-theme_dir
[3]: https://www.mkdocs.org/user-guide/styling-your-docs/#using-the-theme-custom_dir

### Setup and theme structure

@@ -167,7 +167,7 @@ The Material theme provides the following template blocks:

For more on this topic refer to the [MkDocs documentation][4]

[4]: http://www.mkdocs.org/user-guide/styling-your-docs/#overriding-template-blocks
[4]: https://www.mkdocs.org/user-guide/styling-your-docs/#overriding-template-blocks

## Theme development


+ 82
- 2
docs/extensions/codehilite.md View File

@@ -108,7 +108,7 @@ Line numbers can be added by enabling the `linenums` flag in your `mkdocs.yml`:
``` yaml
markdown_extensions:
- codehilite:
linenums:true
linenums: true
```

Example:
@@ -134,6 +134,87 @@ Result:
if items[j] > items[j + 1]:
items[j], items[j + 1] = items[j + 1], items[j]

### Grouping code blocks

The [SuperFences][5] extension which is part of the [PyMdown Extensions][6]
package adds support for grouping code blocks with tabs. This is especially
useful for documenting projects with multiple language bindings.

Example:

````
``` bash tab="Bash"
#!/bin/bash

echo "Hello world!"
```

``` c tab="C"
#include <stdio.h>

int main(void) {
printf("Hello world!\n");
}
```

``` c++ tab="C++"
#include <iostream>

int main() {
std::cout << "Hello world!" << std::endl;
return 0;
}
```

``` c# tab="C#"
using System;

class Program {
static void Main(string[] args) {
Console.WriteLine("Hello world!");
}
}
```
````

Result:

``` bash tab="Bash"
#!/bin/bash

echo "Hello world!"
```

``` c tab="C"
#include <stdio.h>

int main(void) {
printf("Hello world!\n");
}
```

``` c++ tab="C++"
#include <iostream>

int main() {
std::cout << "Hello world!" << std::endl;
return 0;
}
```

``` c# tab="C#"
using System;

class Program {
static void Main(string[] args) {
Console.WriteLine("Hello world!");
}
}
```

[5]: https://facelessuser.github.io/pymdown-extensions/extensions/superfences/
[6]: https://facelessuser.github.io/pymdown-extensions

### Highlighting specific lines

Specific lines can be highlighted by passing the line numbers to the `hl_lines`
@@ -162,7 +243,6 @@ Result:
if items[j] > items[j + 1]:
items[j], items[j + 1] = items[j + 1], items[j]


## Supported languages <small>excerpt</small>

CodeHilite uses [Pygments][2], a generic syntax highlighter with support for

+ 7
- 4
docs/extensions/pymdown.md View File

@@ -237,12 +237,15 @@ symbols ((c), (tm), (r)) and fractions (1/2, 1/4, ...).
lists and other block elements, which the [Fenced Code Blocks][23] extension
from the standard Markdown library doesn't parse correctly.

SuperFences does also allow [grouping code blocks with tabs][24].

[22]: https://facelessuser.github.io/pymdown-extensions/extensions/superfences/
[23]: https://python-markdown.github.io/extensions/fenced_code_blocks/
[24]: codehilite.md#grouping-code-blocks

### Tasklist

[Tasklist][24] adds support for styled checkbox lists. This is useful for
[Tasklist][25] adds support for styled checkbox lists. This is useful for
keeping track of tasks and showing what has been done and has yet to be done.
Checkbox lists are like regular lists, but prefixed with `[ ]` for empty or
`[x]` for filled checkboxes.
@@ -275,12 +278,12 @@ Result:
* [ ] Aenean pretium efficitur erat, donec pharetra, ligula non scelerisque
* [ ] Nulla vel eros venenatis, imperdiet enim id, faucibus nisi

[24]: https://facelessuser.github.io/pymdown-extensions/extensions/tasklist/
[25]: https://facelessuser.github.io/pymdown-extensions/extensions/tasklist/

### Tilde

[Tilde][25] provides an easy way to ~~strike through~~ cross out text.
[Tilde][26] provides an easy way to ~~strike through~~ cross out text.
The portion of text that should be erased must be enclosed in two tildes
`~~...~~` and the extension will take care of the rest.

[25]: https://facelessuser.github.io/pymdown-extensions/extensions/tilde/
[26]: https://facelessuser.github.io/pymdown-extensions/extensions/tilde/

+ 26
- 17
docs/getting-started.md View File

@@ -24,7 +24,7 @@ pip install mkdocs && mkdocs --version

Material requires MkDocs >= 0.17.1.

[1]: http://www.mkdocs.org
[1]: https://www.mkdocs.org

### Installing Material

@@ -319,37 +319,44 @@ translations for all template variables and labels in the following languages:
<tr>
<td><code>ar</code> / Arabic</td>
<td><code>ca</code> / Catalan</td>
<td><code>cs</code> / Czech</td>
<td><code>da</code> / Danish</td>
<td><code>nl</code> / Dutch</td>
</tr>
<tr>
<td><code>nl</code> / Dutch</td>
<td><code>en</code> / English</td>
<td><code>fi</code> / Finnish</td>
<td><code>fr</code> / French</td>
<td><code>fr</code> / Galician</td>
<td><code>de</code> / German</td>
</tr>
<tr>
<td><code>gl</code> / Galician</td>
<td><code>de</code> / German</td>
<td><code>he</code> / Hebrew</td>
<td><code>hi</code> / Hindi</td>
</tr>
<tr>
<td><code>hu</code> / Hungarian</td>
<td><code>it</code> / Italian</td>
<td><code>ja</code> / Japanese</td>
<td><code>kr</code> / Korean</td>
</tr>
<tr>
<td><code>kr</code> / Korean</td>
<td><code>no</code> / Norwegian</td>
<td><code>fa</code> / Persian</td>
<td><code>pl</code> / Polish</td>
<td><code>pt</code> / Portugese</td>
</tr>
<tr>
<td><code>pt</code> / Portugese</td>
<td><code>ru</code> / Russian</td>
<td><code>es</code> / Spanish</td>
<td><code>sv</code> / Swedish</td>
<td><code>sr</code> / Serbian</td>
<td><code>sh</code> / Serbo-Croatian</td>
<td><code>sk</code> / Slovak</td>
</tr>
<tr>
<td><code>es</code> / Spanish</td>
<td><code>sv</code> / Swedish</td>
<td><code>tr</code> / Turkish</td>
<td><code>uk</code> / Ukrainian</td>
<td colspan="2"><code>vi</code> / Vietnamese</td>
</tr>
<tr>
<td colspan="2">
@@ -360,11 +367,11 @@ translations for all template variables and labels in the following languages:
</td>
</tr>
<tr>
<td colspan="4" align="right">
<td><code>vi</code> / Vietnamese</td>
<td colspan="3" align="right">
<a href="http://bit.ly/2EbzFc8">Submit a new language</a>
</td>
</tr>
</tr>
</tbody>
</table>

@@ -452,11 +459,13 @@ At the time of writing, the following languages are supported:
</tbody>
</table>

!!! info "Search language support for Chinese"
!!! warning "MkDocs 1.0 compatibility"

[lunr-languages][18] currently doesn't include a stemmer for Chinese or
other Asian languages, but uses the Japanese stemmer, as some users
reported pretty decent results.
While MkDocs 1.0 supports prebuilding the search index, Material currently
doesn't support this setting as the default search behavior of the original
theme was heavily modified for the sake of a better UX. Integration is
possible, but a small subset of the features Material provides will not be
portable to the prebuilt index mainly due to missing localization.

!!! warning "Only specify the languages you really need"

@@ -536,7 +545,7 @@ set explicitly by setting `extra.repo_icon` to `github`, `gitlab` or
guidance regarding the `edit_uri` attribute, which defines whether the edit
button is shown or not.

[19]: http://www.mkdocs.org/user-guide/configuration/#edit_uri
[19]: https://www.mkdocs.org/user-guide/configuration/#edit_uri

### Adding social links

@@ -635,7 +644,7 @@ Material theme including more information regarding installation and usage:
* [Permalinks][29]
* [PyMdown Extensions][30]

[24]: http://www.mkdocs.org/user-guide/writing-your-docs/#markdown-extensions
[24]: https://www.mkdocs.org/user-guide/writing-your-docs/#markdown-extensions
[25]: extensions/admonition.md
[26]: extensions/codehilite.md
[27]: extensions/footnotes.md

+ 2
- 2
docs/index.md View File

@@ -8,7 +8,7 @@ guidelines.

[![Material for MkDocs](assets/images/material.png)](assets/images/material.png)

[1]: http://www.mkdocs.org
[1]: https://www.mkdocs.org
[2]: https://material.io/guidelines/material-design/

## Quick start
@@ -29,7 +29,7 @@ theme:
## What to expect

* Responsive design and fluid layout for all kinds of screens and devices,
designed to serve your project documentation in a user-friendly way in 25
designed to serve your project documentation in a user-friendly way in 31
languages with optimal readability.

* Easily customizable primary and accent color, fonts, favicon and logo;

+ 79
- 0
docs/release-notes.md View File

@@ -14,6 +14,18 @@ To inspect the currently installed version, use the following command:
pip show mkdocs-material
```

### Material 2.x to 3.x

* Material for MkDocs 3.x requires MkDocs 1.0 because the way paths are resolved
internally changed significantly. Furthermore, `pages` was renamed to `nav`,
so remember to adjust your `mkdocs.yml` file.

* All extended templates *should* continue to work but in order to make them
future-proof the `url` filter should be introduced on all paths. Please see
the [official release notes][_1] for further guidance.

[_1]: https://www.mkdocs.org/about/release-notes/#version-10-2018-08-03

### Material 1.x to 2.x

* Material for MkDocs 2.x requires MkDocs 0.17.1, as this version introduced
@@ -37,6 +49,73 @@ pip show mkdocs-material

## Changelog

### 3.0.3 <small>_ August 7, 2018</small>

* Fixed [#841][841]: Additional path levels for extra CSS and JS

[841]: https://github.com/squidfunk/mkdocs-material/issues/841

### 3.0.2 <small>_ August 6, 2018</small>

* Fixed [#839][839]: Lunr.js stemmer imports incorrect

[839]: https://github.com/squidfunk/mkdocs-material/issues/839

### 3.0.1 <small>_ August 5, 2018</small>

* Fixed [#838][838]: Search result links incorrect

[838]: https://github.com/squidfunk/mkdocs-material/issues/838

### 3.0.0 <small>_ August 5, 2018</small>

* Upgraded MkDocs to 1.0
* Upgraded Python in official Docker image to 3.6
* Added Serbian and Serbo-Croatian translations

### 2.9.4 <small>_ July 29, 2018</small>

* Fixed build error after MkDocs upgrade

### 2.9.3 <small>_ July 29, 2018</small>

* Added link to home for logo in drawer
* Fixed dependency problems between MkDocs and Tornado

### 2.9.2 <small>_ June 29, 2018</small>

* Added Hindi and Czech translations

### 2.9.1 <small>_ June 18, 2018</small>

* Added support for different spellings for theme color
* Fixed [#799][799]: Added support for web font minification in production
* Fixed [#800][800]: Added `.highlighttable` as an alias for `.codehilitetable`

[799]: https://github.com/squidfunk/mkdocs-material/issues/799
[800]: https://github.com/squidfunk/mkdocs-material/issues/800

### 2.9.0 <small>_ June 13, 2018</small>

* Added support for theme color on Android
* Fixed [#796][796]: Rendering of nested tabbed code blocks

[796]: https://github.com/squidfunk/mkdocs-material/issues/796

### 2.8.0 <small>_ June 10, 2018</small>

* Added support for grouping code blocks with tabs
* Added Material and FontAwesome icon fonts to distribution files (GDPR)
* Added note on compliance with GDPR
* Added Slovak translations
* Fixed [#790][790]: Prefixed `id` attributes with `__` to avoid name clashes

[790]: https://github.com/squidfunk/mkdocs-material/issues/790

### 2.7.3 <small>_ April 26, 2018</small>

* Added Finnish translations

### 2.7.2 <small>_ April 9, 2018</small>

* Fixed rendering issue for `details` on Edge

+ 4
- 4
docs/specimen.md View File

@@ -10,7 +10,7 @@ tempor.

**Sed suscipit**, orci non pretium pretium, quam mi gravida metus, vel
venenatis justo est condimentum diam. Maecenas non ornare justo. Nam a ipsum
eros. [Nulla aliquam](/) orci sit amet nisl posuere malesuada. Proin aliquet
eros. [Nulla aliquam](#) orci sit amet nisl posuere malesuada. Proin aliquet
nulla velit, quis ultricies orci feugiat et. `Ut tincidunt sollicitudin`
tincidunt. Aenean ullamcorper sit amet nulla at interdum.

@@ -46,7 +46,7 @@ tincidunt. Aenean ullamcorper sit amet nulla at interdum.

> **Sed aliquet**, neque at rutrum mollis, neque nisi tincidunt nibh, vitae
faucibus lacus nunc at lacus. Nunc scelerisque, quam id cursus sodales, lorem
[libero fermentum](/) urna, ut efficitur elit ligula et nunc.
[libero fermentum](#) urna, ut efficitur elit ligula et nunc.

> > Mauris dictum mi lacus, sit amet pellentesque urna vehicula fringilla.
Ut sit amet placerat ante. Proin sed elementum nulla. Nunc vitae sem odio.
@@ -161,7 +161,7 @@ Cras arcu libero

Morbi eget `dapibus felis`. Vivamus *`venenatis porttitor`* tortor sit amet
rutrum. Class aptent taciti sociosqu ad litora torquent per conubia nostra,
per inceptos himenaeos. [`Pellentesque aliquet quam enim`](/), eu volutpat urna
per inceptos himenaeos. [`Pellentesque aliquet quam enim`](#), eu volutpat urna
rutrum a.

Nam vehicula nunc `:::js return target` mauris, a ultricies libero efficitur
@@ -216,7 +216,7 @@ at elementum urna sodales vitae. In in vehicula nulla, quis ornare libero.
| Left | Center | Right |
| :--------- | :------: | ------: |
| Lorem | *dolor* | `amet` |
| [ipsum](/) | **sit** | |
| [ipsum](#) | **sit** | |

Vestibulum vitae orci quis ante viverra ultricies ut eget turpis. Sed eu
lectus dapibus, eleifend nulla varius, lobortis turpis. In ac hendrerit nisl,

+ 4
- 0
material/assets/fonts/font-awesome.css
File diff suppressed because it is too large
View File


+ 13
- 0
material/assets/fonts/material-icons.css View File

@@ -0,0 +1,13 @@
/*!
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy
* of the License at:
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING, SOFTWARE
* DISTRIBUTED UNDER THE LICENSE IS DISTRIBUTED ON AN "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
* SEE THE LICENSE FOR THE SPECIFIC LANGUAGE GOVERNING PERMISSIONS AND
* LIMITATIONS UNDER THE LICENSE.
*/@font-face{font-family:"Material Icons";font-style:normal;font-weight:400;src:local("Material Icons"),local("MaterialIcons-Regular"),url("specimen/MaterialIcons-Regular.woff2") format("woff2"),url("specimen/MaterialIcons-Regular.woff") format("woff"),url("specimen/MaterialIcons-Regular.ttf") format("truetype")}

BIN
material/assets/fonts/specimen/FontAwesome.ttf View File


BIN
material/assets/fonts/specimen/FontAwesome.woff View File


BIN
material/assets/fonts/specimen/FontAwesome.woff2 View File


BIN
material/assets/fonts/specimen/MaterialIcons-Regular.ttf View File


BIN
material/assets/fonts/specimen/MaterialIcons-Regular.woff View File


BIN
material/assets/fonts/specimen/MaterialIcons-Regular.woff2 View File


material/assets/images/icons/bitbucket.4ebea66e.svg → material/assets/images/icons/bitbucket.1b09e088.svg View File

@@ -1,5 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="352" height="448"
viewBox="0 0 352 448" id="bitbucket">
viewBox="0 0 352 448" id="__bitbucket">
<path fill="currentColor" d="M203.75 214.75q2 15.75-12.625 25.25t-27.875
1.5q-9.75-4.25-13.375-14.5t-0.125-20.5 13-14.5q9-4.5 18.125-3t16 8.875
6.875 16.875zM231.5 209.5q-3.5-26.75-28.25-41t-49.25-3.25q-15.75

material/assets/images/icons/github.a4034fb1.svg → material/assets/images/icons/github.f0b8504a.svg View File

@@ -1,5 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="416" height="448"
viewBox="0 0 416 448" id="github">
viewBox="0 0 416 448" id="__github">
<path fill="currentColor" d="M160 304q0 10-3.125 20.5t-10.75 19-18.125
8.5-18.125-8.5-10.75-19-3.125-20.5 3.125-20.5 10.75-19 18.125-8.5
18.125 8.5 10.75 19 3.125 20.5zM320 304q0 10-3.125 20.5t-10.75

material/assets/images/icons/gitlab.348cdb3a.svg → material/assets/images/icons/gitlab.6dd19c00.svg View File

@@ -1,5 +1,5 @@
<svg xmlns="http://www.w3.org/2000/svg" width="500" height="500"
viewBox="0 0 500 500" id="gitlab">
viewBox="0 0 500 500" id="__gitlab">
<g transform="translate(156.197863, 1.160267)">
<path fill="currentColor"
d="M93.667,473.347L93.667,473.347l90.684-279.097H2.983L93.667,

+ 0
- 1
material/assets/javascripts/application.0cf9b500.js
File diff suppressed because it is too large
View File


+ 1
- 0
material/assets/javascripts/application.e72fd936.js
File diff suppressed because it is too large
View File


+ 1176
- 0
material/assets/stylesheets/application-palette.22915126.css
File diff suppressed because it is too large
View File


+ 0
- 2
material/assets/stylesheets/application-palette.6079476c.css
File diff suppressed because it is too large
View File


+ 2552
- 0
material/assets/stylesheets/application.451f80e5.css
File diff suppressed because it is too large
View File


+ 0
- 2
material/assets/stylesheets/application.8d40d89b.css
File diff suppressed because it is too large
View File


+ 30
- 23
material/base.html View File

@@ -35,8 +35,8 @@
] %}
<meta name="lang:{{ key }}" content="{{ lang.t(key) }}">
{% endfor %}
<link rel="shortcut icon" href="{{ base_url }}/{{ config.theme.favicon }}">
<meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-material-2.7.2">
<link rel="shortcut icon" href="{{ config.theme.favicon | url }}">
<meta name="generator" content="mkdocs-{{ mkdocs_version }}, mkdocs-material-3.0.3">
{% endblock %}
{% block htmltitle %}
{% if page and page.meta and page.meta.title %}
@@ -48,13 +48,20 @@
{% endif %}
{% endblock %}
{% block styles %}
<link rel="stylesheet" href="{{ base_url }}/assets/stylesheets/application.8d40d89b.css">
<link rel="stylesheet" href="{{ 'assets/stylesheets/application.451f80e5.css' | url }}">
{% if palette.primary or palette.accent %}
<link rel="stylesheet" href="{{ base_url }}/assets/stylesheets/application-palette.6079476c.css">
<link rel="stylesheet" href="{{ 'assets/stylesheets/application-palette.22915126.css' | url }}">
{% endif %}
{% if palette.primary %}
{% import "partials/palette.html" as map %}
{% set primary = map.primary(
palette.primary | replace(" ", "-") | lower
) %}
<meta name="theme-color" content="{{ primary }}">
{% endif %}
{% endblock %}
{% block libs %}
<script src="{{ base_url }}/assets/javascripts/modernizr.1aa3b519.js"></script>
<script src="{{ 'assets/javascripts/modernizr.1aa3b519.js' | url }}"></script>
{% endblock %}
{% block fonts %}
<link href="https://fonts.gstatic.com" rel="preconnect" crossorigin>
@@ -65,10 +72,10 @@
}}">
<style>body,input{font-family:"{{ font.text }}","Helvetica Neue",Helvetica,Arial,sans-serif}code,kbd,pre{font-family:"{{ font.code }}","Courier New",Courier,monospace}</style>
{% endif %}
<link rel="stylesheet" href="https://fonts.googleapis.com/icon?family=Material+Icons">
{% endblock %}
{% for path in extra_css %}
<link rel="stylesheet" href="{{ path }}">
<link rel="stylesheet" href="{{ 'assets/fonts/material-icons.css' | url }}">
{% for path in config["extra_css"] %}
<link rel="stylesheet" href="{{ path | url }}">
{% endfor %}
{% block extrahead %}{% endblock %}
</head>
@@ -83,19 +90,19 @@
<defs>
{% set platform = config.extra.repo_icon or config.repo_url %}
{% if "github" in platform %}
{% include "assets/images/icons/github.a4034fb1.svg" %}
{% include "assets/images/icons/github.f0b8504a.svg" %}
{% elif "gitlab" in platform %}
{% include "assets/images/icons/gitlab.348cdb3a.svg" %}
{% include "assets/images/icons/gitlab.6dd19c00.svg" %}
{% elif "bitbucket" in platform %}
{% include "assets/images/icons/bitbucket.4ebea66e.svg" %}
{% include "assets/images/icons/bitbucket.1b09e088.svg" %}
{% endif %}
</defs>
</svg>
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="search" autocomplete="off">
<label class="md-overlay" data-md-component="overlay" for="drawer"></label>
<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
<label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
{% if page.toc | first is defined %}
<a href="{{ (page.toc | first).url }}" tabindex="1" class="md-skip">
<a href="{{ (page.toc | first).url | url }}" tabindex="1" class="md-skip">
{{ lang.t('skip.link.title') }}
</a>
{% endif %}
@@ -167,30 +174,30 @@
{% endblock %}
</div>
{% block scripts %}
<script src="{{ base_url }}/assets/javascripts/application.0cf9b500.js"></script>
<script src="{{ 'assets/javascripts/application.e72fd936.js' | url }}"></script>
{% if lang.t("search.language") != "en" %}
{% set languages = lang.t("search.language").split(",") %}
{% if languages | length and languages[0] != "" %}
{% set path = base_url + "/assets/javascripts/lunr" %}
<script src="{{ path }}/lunr.stemmer.support.js"></script>
{% set path = "assets/javascripts/lunr/" %}
<script src="{{ (path ~ 'lunr.stemmer.support.js') | url }}"></script>
{% for language in languages | map("trim") %}
{% if language != "en" %}
{% if language == "jp" %}
<script src="{{ path }}/tinyseg.js"></script>
<script src="{{ (path ~ 'tinyseg.js') | url }}"></script>
{% endif %}
{% if language in ("da", "de", "du", "es", "fi", "fr", "hu", "it", "jp", "no", "pt", "ro", "ru", "sv", "tr") %}
<script src="{{ path }}/lunr.{{ language }}.js"></script>
<script src="{{ (path ~ 'lunr.' ~ language ~ '.js') | url }}"></script>
{% endif %}
{% endif %}
{% endfor %}
{% if languages | length > 1 %}
<script src="{{ path }}/lunr.multi.js"></script>
<script src="{{ (path ~ 'lunr.multi.js') | url }}"></script>
{% endif %}
{% endif %}
{% endif %}
<script>app.initialize({version:"{{ mkdocs_version }}",url:{base:"{{ base_url }}"}})</script>
{% for path in extra_javascript %}
<script src="{{ path }}"></script>
{% for path in config["extra_javascript"] %}
<script src="{{ path | url }}"></script>
{% endfor %}
{% endblock %}
{% block analytics %}

+ 3
- 3
material/partials/footer.html View File

@@ -4,7 +4,7 @@
<div class="md-footer-nav">
<nav class="md-footer-nav__inner md-grid">
{% if page.previous_page %}
<a href="{{ page.previous_page.url }}" title="{{ page.previous_page.title }}" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<a href="{{ page.previous_page.url | url }}" title="{{ page.previous_page.title }}" class="md-flex md-footer-nav__link md-footer-nav__link--prev" rel="prev">
<div class="md-flex__cell md-flex__cell--shrink">
<i class="md-icon md-icon--arrow-back md-footer-nav__button"></i>
</div>
@@ -19,7 +19,7 @@
</a>
{% endif %}
{% if page.next_page %}
<a href="{{ page.next_page.url }}" title="{{ page.next_page.title }}" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<a href="{{ page.next_page.url | url }}" title="{{ page.next_page.title }}" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
<div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
<span class="md-flex__ellipsis">
<span class="md-footer-nav__direction">
@@ -45,7 +45,7 @@
</div>
{% endif %}
powered by
<a href="http://www.mkdocs.org">MkDocs</a>
<a href="https://www.mkdocs.org">MkDocs</a>
and
<a href="https://squidfunk.github.io/mkdocs-material/">
Material for MkDocs</a>

+ 4
- 6
material/partials/header.html View File

@@ -2,18 +2,16 @@
<nav class="md-header-nav md-grid">
<div class="md-flex">
<div class="md-flex__cell md-flex__cell--shrink">
<a href="{{ config.site_url | default(nav.homepage.url, true) }}" title="{{ config.site_name }}" class="md-header-nav__button md-logo">
<a href="{{ config.site_url | default(nav.homepage.url, true) | url }}" title="{{ config.site_name }}" class="md-header-nav__button md-logo">
{% if config.theme.logo.icon %}
<i class="md-icon">{{ config.theme.logo.icon }}</i>
{% elif config.theme.logo.startswith("http") %}
<img src="{{ config.theme.logo }}" width="24" height="24">
{% else %}
<img src="{{ base_url }}/{{ config.theme.logo }}" width="24" height="24">
<img src="{{ config.theme.logo | url }}" width="24" height="24">
{% endif %}
</a>
</div>
<div class="md-flex__cell md-flex__cell--shrink">
<label class="md-icon md-icon--menu md-header-nav__button" for="drawer"></label>
<label class="md-icon md-icon--menu md-header-nav__button" for="__drawer"></label>
</div>
<div class="md-flex__cell md-flex__cell--stretch">
<div class="md-flex__ellipsis md-header-nav__title" data-md-component="title">
@@ -34,7 +32,7 @@
<div class="md-flex__cell md-flex__cell--shrink">
{% block search_box %}
{% if "search" in config["plugins"] %}
<label class="md-icon md-icon--search md-header-nav__button" for="search"></label>
<label class="md-icon md-icon--search md-header-nav__button" for="__search"></label>
{% include "partials/search.html" %}
{% endif %}
{% endblock %}

+ 20
- 0
material/partials/language/cs.html View File

@@ -0,0 +1,20 @@
{% macro t(key) %}{{ {
"language": "cs",
"clipboard.copy": "Kopírovat do schránky",
"clipboard.copied": "Zkopírováno do schránky",
"edit.link.title": "Upravit tuto stránku",
"footer.previous": "Předchozí",
"footer.next": "Další",
"meta.comments": "Komentáře",
"meta.source": "Zdroj",
"search.language": "ro",
"search.placeholder": "Hledat",
"search.result.placeholder": "Pište co se má vyhledat",
"search.result.none": "Nenalezeny žádné dokumenty",
"search.result.one": "Nalezený dokument: 1",
"search.result.other": "Nalezené dokumenty: #",
"search.tokenizer": "[\s\-]+",
"skip.link.title": "Přeskočit obsah",
"source.link.title": "Přejít do repozitáře",
"toc.title": "Obsah"
}[key] }}{% endmacro %}

+ 19
- 0
material/partials/language/fi.html View File

@@ -0,0 +1,19 @@
{% macro t(key) %}{{ {
"language": "fi",
"clipboard.copy": "Kopioi leikepöydälle",
"clipboard.copied": "Kopioitu leikepöydälle",
"edit.link.title": "Muokkaa tätä sivua",
"footer.previous": "Edellinen",
"footer.next": "Seuraava",
"meta.comments": "Kommentit",
"meta.source": "Lähdekodi",
"search.language": "fi",
"search.placeholder": "Hae",
"search.result.placeholder": "Kirjoita aloittaaksesi haun",
"search.result.none": "Ei täsmääviä dokumentteja",
"search.result.one": "1 täsmäävä dokumentti",
"search.result.other": "# täsmäävää dokumenttia",
"skip.link.title": "Hyppää sisältöön",
"source.link.title": "Mene repositoryyn",
"toc.title": "Sisällysluettelo"
}[key] }}{% endmacro %}

+ 22
- 0
material/partials/language/hi.html View File

@@ -0,0 +1,22 @@
{% macro t(key) %}{{ {
"language": "hi",
"clipboard.copy": "क्लिपबोर्ड पर कॉपी करें",
"clipboard.copied": "क्लिपबोर्ड पर कॉपी कर दिया गया",
"edit.link.title": "इस पृष्ठ को संपादित करें",
"footer.previous": "पिछला",
"footer.next": "आगामी",
"meta.comments": "टिप्पणियाँ",
"meta.source": "स्रोत",
"search.language": "",
"search.pipeline.stopwords": false,
"search.pipeline.trimmer": false,
"search.placeholder": "खोज",
"search.result.placeholder": "खोज शुरू करने के लिए टाइप करें",
"search.result.none": "कोई मिलान डॉक्यूमेंट नहीं",
"search.result.one": "1 मिलान डॉक्यूमेंट",
"search.result.other": "# मिलान डाक्यूमेंट्स",
"search.tokenizer": "[\s\-]+",
"skip.link.title": "विषय पर बढ़ें",
"source.link.title": "रिपॉजिटरी पर जाएं",
"toc.title": "विषय - सूची"
}[key] }}{% endmacro %}

+ 20
- 0
material/partials/language/sh.html View File

@@ -0,0 +1,20 @@
{% macro t(key) %}{{ {
"language": "sh",
"clipboard.copy": "Kopiraj u klipbord",
"clipboard.copied": "Iskopirano u klipbord",
"edit.link.title": "Uredi stranicu",
"footer.previous": "Prethodno",
"footer.next": "Sledeće",
"meta.comments": "Komentari",
"meta.source": "Izvor",
"search.language": "ro",
"search.placeholder": "Pretraga",
"search.result.placeholder": "Unesite pojam pretrage",
"search.result.none": "Ništa nije pronađeno",
"search.result.one": "1 rezultat pretrage",
"search.result.other": "# rezultata pretrage",
"search.tokenizer": "[\s\-]+",
"skip.link.title": "Idi na tekst",
"source.link.title": "Idi u repozitorijum",
"toc.title": "Sadržaj"
}[key] }}{% endmacro %}

+ 19
- 0
material/partials/language/sk.html View File

@@ -0,0 +1,19 @@
{% macro t(key) %}{{ {
"language": "sk",
"clipboard.copy": "Kopírovať do schránky",
"clipboard.copied": "Skopírované do schránky",
"edit.link.title": "Upraviť túto stránku",
"footer.previous": "Späť",
"footer.next": "Ďalej",
"meta.comments": "Komentáre",
"meta.source": "Zdroj",
"search.language": "sk",
"search.placeholder": "Hľadať",
"search.result.placeholder": "Pre vyhľadávanie začni písať",
"search.result.none": "Žiadne vyhovujúce dokumenty",
"search.result.one": "Vyhovujúci dokument: 1",
"search.result.other": "Vyhovujúce dokumenty: #",
"skip.link.title": "Preskočiť na obsah",
"source.link.title": "Zobraziť repozitár",
"toc.title": "Obsah"
}[key] }}{% endmacro %}

+ 22
- 0
material/partials/language/sr.html View File

@@ -0,0 +1,22 @@
{% macro t(key) %}{{ {
"language": "sr",
"clipboard.copy": "Копирај у клипборд",
"clipboard.copied": "Ископирано у клипборд",
"edit.link.title": "Уреди страницу",
"footer.previous": "Претходно",
"footer.next": "Следеће",
"meta.comments": "Коментари",
"meta.source": "Извор",
"search.language": "",
"search.pipeline.stopwords": false,
"search.pipeline.trimmer": false,
"search.placeholder": "Претрага",
"search.result.placeholder": "Унесите појам претраге",
"search.result.none": "Нису пронађени документи",
"search.result.one": "1 резултат претраге",
"search.result.other": "# резултата претраге",
"search.tokenizer": "[\s\-]+",
"skip.link.title": "Иди на текст",
"source.link.title": "Иди у репозиторијум",
"toc.title": "Садржај"
}[key] }}{% endmacro %}

+ 4
- 4
material/partials/nav-item.html View File

@@ -29,16 +29,16 @@
{% elif nav_item == page %}
<li class="{{ class }}">
{% set toc_ = page.toc %}
<input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="toc">
<input class="md-toggle md-nav__toggle" data-md-toggle="toc" type="checkbox" id="__toc">
{% if toc_ | first is defined and "\x3ch1 id=" in page.content %}
{% set toc_ = (toc_ | first).children %}
{% endif %}
{% if toc_ | first is defined %}
<label class="md-nav__link md-nav__link--active" for="toc">
<label class="md-nav__link md-nav__link--active" for="__toc">
{{ nav_item.title }}
</label>
{% endif %}
<a href="{{ nav_item.url }}" title="{{ nav_item.title }}" class="md-nav__link md-nav__link--active">
<a href="{{ nav_item.url | url }}" title="{{ nav_item.title }}" class="md-nav__link md-nav__link--active">
{{ nav_item.title }}
</a>
{% if toc_ | first is defined %}
@@ -47,7 +47,7 @@
</li>
{% else %}
<li class="{{ class }}">
<a href="{{ nav_item.url }}" title="{{ nav_item.title }}" class="md-nav__link">
<a href="{{ nav_item.url | url }}" title="{{ nav_item.title }}" class="md-nav__link">
{{ nav_item.title }}
</a>
</li>

+ 4
- 6
material/partials/nav.html View File

@@ -1,14 +1,12 @@
<nav class="md-nav md-nav--primary" data-md-level="0">
<label class="md-nav__title md-nav__title--site" for="drawer">
<span class="md-nav__button md-logo">
<label class="md-nav__title md-nav__title--site" for="__drawer">
<a href="{{ config.site_url | default(nav.homepage.url, true) | url }}" title="{{ config.site_name }}" class="md-nav__button md-logo">
{% if config.theme.logo.icon %}
<i class="md-icon">{{ config.theme.logo.icon }}</i>
{% elif config.theme.logo.startswith("http") %}
<img src="{{ config.theme.logo }}" width="48" height="48">
{% else %}
<img src="{{ base_url }}/{{ config.theme.logo }}" width="48" height="48">
<img src="{{ config.theme.logo | url }}" width="48" height="48">
{% endif %}
</span>
</a>
{{ config.site_name }}
</label>
{% if config.repo_url %}

+ 39
- 0
material/partials/palette.html View File

@@ -0,0 +1,39 @@
{% macro primary(key) %}{{ {
"red": "#ef5350",
"pink": "#e91e63",
"purple": "#ab47bc",
"deep-purple": "#7e57c2",
"indigo": "#3f51b5",
"blue": "#2196f3",
"light-blue": "#03a9f4",
"cyan": "#00bcd4",
"teal": "#009688",
"green": "#4caf50",
"light-green": "#7cb342",
"lime": "#c0ca33",
"yellow": "#f9a825",
"amber": "#ffa000",
"orange": "#fb8c00",
"deep-orange": "#ff7043",
"brown": "#795548",
"grey": "#757575",
"blue-grey": "#546e7a"
}[key] }}{% endmacro %}
{% macro accent(key) %}{{ {
"red": "#ff1744",
"pink": "#f50057",
"purple": "#e040fb",
"deep-purple": "#7c4dff",
"indigo": "#536dfe",
"blue": "#448aff",
"light-blue": "#0091ea",
"cyan": "#00b8d4",
"teal": "#00bfa5",
"green": "#00c853",
"light-green": "#64dd17",
"lime": "#aeea00",
"yellow": "#ffd600",
"amber": "#ffab00",
"orange": "#ff9100",
"deep-orange": "#ff6e40"
}[key] }}{% endmacro %}

+ 2
- 2
material/partials/search.html View File

@@ -1,10 +1,10 @@
{% import "partials/language.html" as lang with context %}
<div class="md-search" data-md-component="search" role="dialog">
<label class="md-search__overlay" for="search"></label>
<label class="md-search__overlay" for="__search"></label>
<div class="md-search__inner" role="search">
<form class="md-search__form" name="search">
<input type="text" class="md-search__input" name="query" placeholder="{{ lang.t('search.placeholder') }}" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="query" data-md-state="active">
<label class="md-icon md-search__icon" for="search"></label>
<label class="md-icon md-search__icon" for="__search"></label>
<button type="reset" class="md-icon md-search__icon" data-md-component="reset" tabindex="-1">
&#xE5CD;
</button>

+ 1
- 2
material/partials/social.html View File

@@ -1,7 +1,6 @@
{% if config.extra.social %}
<div class="md-footer-social">
{% set path = "ajax/libs/font-awesome/4.7.0/css/font-awesome.min.css" %}
<link rel="stylesheet" href="https://cdnjs.cloudflare.com/{{ path }}">
<link rel="stylesheet" href="{{ base_url }}/assets/fonts/font-awesome.css">
{% for social in config.extra.social %}
<a href="{{ social.link }}" class="md-footer-social__link fa fa-{{ social.type }}"></a>
{% endfor %}

+ 1
- 1
material/partials/source.html View File

@@ -14,7 +14,7 @@
{% if repo_type %}
<div class="md-source__icon">
<svg viewBox="0 0 24 24" width="24" height="24">
<use xlink:href="#{{ repo_type }}" width="24" height="24"></use>
<use xlink:href="#__{{ repo_type }}" width="24" height="24"></use>
</svg>
</div>
{% endif %}

+ 5
- 5
material/partials/tabs-item.html View File

@@ -1,28 +1,28 @@
{% if nav_item.is_homepage %}
<li class="md-tabs__item">
{% if not page.ancestors | length and nav | selectattr("url", page.url) %}
<a href="{{ nav_item.url }}" title="{{ nav_item.title }}" class="md-tabs__link md-tabs__link--active">
<a href="{{ nav_item.url | url }}" title="{{ nav_item.title }}" class="md-tabs__link md-tabs__link--active">
{{ nav_item.title }}
</a>
{% else %}
<a href="{{ nav_item.url }}" title="{{ nav_item.title }}" class="md-tabs__link">
<a href="{{ nav_item.url | url }}" title="{{ nav_item.title }}" class="md-tabs__link">
{{ nav_item.title }}
</a>
{% endif %}
</li>
{% elif nav_item.children and nav_item.children | length > 0 %}
{% set title = title | default(nav_item.title) %}
{% if (nav_item.children | first).children | length > 0 %}
{% if (nav_item.children | first).children %}
{% set nav_item = nav_item.children | first %}
{% include "partials/tabs-item.html" %}
{% else %}
<li class="md-tabs__item">
{% if nav_item.active %}
<a href="{{ (nav_item.children | first).url }}" title="{{ title }}" class="md-tabs__link md-tabs__link--active">
<a href="{{ (nav_item.children | first).url | url }}" title="{{ title }}" class="md-tabs__link md-tabs__link--active">
{{ title }}
</a>
{% else %}
<a href="{{ (nav_item.children | first).url }}" title="{{ title }}" class="md-tabs__link">
<a href="{{ (nav_item.children | first).url | url }}" title="{{ title }}" class="md-tabs__link">
{{ title }}
</a>
{% endif %}

+ 1
- 1
material/partials/toc.html View File

@@ -5,7 +5,7 @@
{% set toc_ = (toc_ | first).children %}
{% endif %}
{% if toc_ | first is defined %}
<label class="md-nav__title" for="toc">{{ lang.t("toc.title") }}</label>
<label class="md-nav__title" for="__toc">{{ lang.t("toc.title") }}</label>
<ul class="md-nav__list" data-md-scrollfix>
{% for toc_item in toc_ %}
{% include "partials/toc-item.html" %}

+ 2
- 1
mkdocs.yml View File

@@ -100,7 +100,7 @@ markdown_extensions:
- pymdownx.tilde

# Page tree
pages:
nav:
- Material: index.md
- Getting started: getting-started.md
- Extensions:
@@ -112,6 +112,7 @@ pages:
- PyMdown: extensions/pymdown.md
- Specimen: specimen.md
- Customization: customization.md
- Compliance with GDPR: compliance.md
- Release notes: release-notes.md
- Author's notes: authors-notes.md
- Contributing: contributing.md

+ 8276
- 8524
package-lock.json
File diff suppressed because it is too large
View File


+ 8
- 7
package.json View File

@@ -1,6 +1,6 @@
{
"name": "mkdocs-material",
"version": "2.7.2",
"version": "3.0.3",
"description": "A Material Design theme for MkDocs",
"keywords": [
"mkdocs",
@@ -31,20 +31,21 @@
},
"dependencies": {},
"devDependencies": {
"autoprefixer": "^8.0.0",
"autoprefixer": "^9.0.1",
"babel-cli": "^6.26.0",
"babel-core": "^6.25.0",
"babel-eslint": "^8.0.0",
"babel-loader": "^7.1.1",
"babel-plugin-add-module-exports": "^0.2.1",
"babel-plugin-add-module-exports": "^0.3.1",
"babel-plugin-transform-react-jsx": "^6.24.1",
"babel-preset-env": "^1.6.1",
"chalk": "^2.0.1",
"clipboard": "^2.0.0",
"copy-webpack-plugin": "^4.2.1",
"css-loader": "^0.28.7",
"css-mqpacker": "^6.0.1",
"custom-event-polyfill": "^0.3.0",
"css-loader": "^1.0.0",
"css-mqpacker": "^7.0.0",
"cssmin": "^0.4.3",
"custom-event-polyfill": "^1.0.6",
"customizr": "^1.0.0-alpha",
"escape-string-regexp": "^1.0.5",
"eslint": "^4.3.0",
@@ -65,7 +66,7 @@
"modularscale-sass": "^3.0.3",
"node-sass": "^4.7.2",
"postcss-loader": "^2.0.8",
"promise-polyfill": "^7.0.0",
"promise-polyfill": "^8.0.0",
"sass-loader": "^6.0.6",
"style-loader": "^0.20.0",
"stylelint": "^9.0.0",

+ 2
- 5
requirements.txt View File

@@ -19,9 +19,6 @@
# IN THE SOFTWARE.

# Direct dependencies
mkdocs>=0.17.1
mkdocs>=1
Pygments>=2.2
pymdown-extensions>=4.10

# Temporary fix for build errors on Travis
tornado<5
pymdown-extensions>=4.11

+ 16
- 1
webpack.config.js View File

@@ -21,6 +21,7 @@
*/

const fs = require("fs")
const cssmin = require("cssmin")
const path = require("path")
const html = require("html-minifier")
const uglify = require("uglify-js")
@@ -40,7 +41,7 @@ const ManifestPlugin = require("webpack-manifest-plugin")
* Configuration
* ------------------------------------------------------------------------- */

module.exports = env => {
module.exports = env => { // eslint-disable-line complexity
const config = {

/* Entrypoints */
@@ -122,6 +123,20 @@ module.exports = env => {
}
},

/* Copy web font files */
{
context: "src",
from: "assets/fonts/**/*",
ignore: "**/*.css"
},

/* Copy and minify web font stylesheets */
{
context: "src",
from: "assets/fonts/*.css",
transform: content => cssmin(content.toString())
},

/* Copy images without cache busting */
{
context: "src",

Loading…
Cancel
Save