首页    技术博客    PHP教程    数据库技术    前端开发   HTML5    Nginx    php论坛
新用户注册 | 会员登录
加入会员，解锁专属内容
取消
热门标签 | HotTags
当前位置:  开发笔记 > 编程语言 > 正文

Octiconsgotmissing

作者：mobiledu2502923673 | 来源：互联网 | 2023-06-29 13:46
Therearewrapperspoilersforinfoinreport[x]the


There are wrapper spoilers for info in report


  • [x] ... the documentation does not mention anything about my problem

  • [ ] ... the problem doesn't occur with the default MkDocs template

  • [ ] ... the problem is not in any of my customizations (CSS, JS, template)

  • [x] ... there are no open or closed issues that are related to my problem

Description

From the get-go, during debugging in Gitter

1
martinbira

helped to notice that Octicons support got missing on the project front page: https://squidfunk.github.io/mkdocs-material/extensions/pymdown/#icons, observe there is literal

1
:octicons-octoface:

there.

Original bug report message:

I am having a trivial problem. I migrate from v4 to v5.

1
2
3
4
5
yaml

extra:

  social:

    - icon: octicons/mark-github

      link: &＃039;https://github.com/Anton-Latukha&＃039;

Docs, not directly, tell that Octicons seems to be supported out of the box, and that they live in the

1
octicons

namespace.

I exhausted variants,

1
octicons

or

1
octicon

or without namespace,

1
mark-github

or

1
github

.

As only

1
fontawesome

example covered in a docs, and indeed

1
fontawesome/brands/github-alt

works, but

1
octicons/mark-github

does not worked for me.

Wrapper: Error log:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
text

> docker run --rm -it -p 8000:8000 -v (pwd):/docs mkdocs-material build



INFO    -  Cleaning site directory

INFO    -  Building documentation to directory: /docs/Anton-Latukha.github.io

Traceback (most recent call last):

  File "/usr/local/bin/mkdocs", line 8, in

    sys.exit(cli())

  File "/usr/local/lib/python3.8/site-packages/click/core.py", line 829, in __call__

    return self.main(*args, **kwargs)

  File "/usr/local/lib/python3.8/site-packages/click/core.py", line 782, in main

    rv &＃061; self.invoke(ctx)

  File "/usr/local/lib/python3.8/site-packages/click/core.py", line 1259, in invoke

    return _process_result(sub_ctx.command.invoke(sub_ctx))

  File "/usr/local/lib/python3.8/site-packages/click/core.py", line 1066, in invoke

    return ctx.invoke(self.callback, **ctx.params)

  File "/usr/local/lib/python3.8/site-packages/click/core.py", line 610, in invoke

    return callback(*args, **kwargs)

  File "/usr/local/lib/python3.8/site-packages/mkdocs/__main__.py", line 152, in build_command

    build.build(config.load_config(**kwargs), dirty&＃061;not clean)

  File "/usr/local/lib/python3.8/site-packages/mkdocs/commands/build.py", line 285, in build

    _build_theme_template(template, env, files, config, nav)

  File "/usr/local/lib/python3.8/site-packages/mkdocs/commands/build.py", line 108, in _build_theme_template

    output &＃061; _build_template(template_name, template, files, config, nav)

  File "/usr/local/lib/python3.8/site-packages/mkdocs/commands/build.py", line 87, in _build_template

    output &＃061; template.render(context)

  File "/usr/local/lib/python3.8/site-packages/jinja2/environment.py", line 1090, in render

    self.environment.handle_exception()

  File "/usr/local/lib/python3.8/site-packages/jinja2/environment.py", line 832, in handle_exception

    reraise(*rewrite_traceback_stack(source&＃061;source))

  File "/usr/local/lib/python3.8/site-packages/jinja2/_compat.py", line 28, in reraise

    raise value.with_traceback(tb)

  File "/usr/local/lib/python3.8/site-packages/material/404.html", line 4, in top-level template code

    {% extends "base.html" %}

  File "/usr/local/lib/python3.8/site-packages/material/base.html", line 180, in top-level template code

    {% block footer %}

  File "/usr/local/lib/python3.8/site-packages/material/base.html", line 181, in block "footer"

    {% include "partials/footer.html" %}

  File "/usr/local/lib/python3.8/site-packages/material/partials/footer.html", line 55, in top-level template code

    {% include "partials/social.html" %}

  File "/usr/local/lib/python3.8/site-packages/material/partials/social.html", line 13, in top-level template code

    {% include ".icons/" ~ social.icon ~ ".svg" %}

  File "/usr/local/lib/python3.8/site-packages/jinja2/loaders.py", line 197, in get_source

    raise TemplateNotFound(template)

jinja2.exceptions.TemplateNotFound: .icons/octicons/mark-github.svg



Expected behavior


1
octicons/mark-github

to work and be provided as an example in the doc.

Actual behavior

Octicons are currently missing.

Steps to reproduce the bug

To reproduce:

I am using the freshest

1
master

1 "Prepare 5.3.3 release" commit 09e5e38a5ccd7cfaf07a58d81a95e3667d1d2d72.
2. On that checkout I use fresh current container build from the current Dockerfile.
3. So I receive

1
master

and rebase onto it a minor

1
Dockerfile

addition:

1
2
3
4
5
Dockerfile

RUN  pip install --no-cache-dir \

                 pygments \

                 pymdown-extensions \

                 mkdocs-htmlproofer-plugin

, which should not involve in the case of the report.

Package versions

Gathered from whithin Dockerfile container:
*

1
Python 3.8.1

*

1
mkdocs, version 1.1.2 from /usr/local/lib/python3.8/site-packages/mkdocs (Python 3.8)

* Material:

1
Version: 5.3.3

Project configuration

Currently:

Wrapper: `mkdocs.yml`:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
 yaml

# Project information

site_name: &＃039;Latukha: Good day my friend!&＃039;

site_description: &＃039;Official page of Anton Latukha&＃039;

site_author: &＃039;Anton Latukha&＃039;

site_url: &＃039;https://blog.latukha.com&＃039;

site_dir: &＃039;Anton-Latukha.github.io&＃039;



# Structure

nav:

  - &＃039;Home&＃039;: &＃039;index.md&＃039;

  - &＃039;Biography&＃039;: &＃039;bio.md&＃039;

  - &＃039;About&＃039;: &＃039;about.md&＃039;

  - Articles:

    - &＃039;Fundamental Haskell notes&＃039;: &＃039;haskell-notes.html&＃039;

    - &＃039;Integrating NixOS/Nix, Haskell IDE Engine, Emacs&＃039;: &＃039;NixOS-HIE-Emacs.md&＃039;

    - &＃039;Restore of deleted LVM (Advanced)&＃039;: &＃039;2017-05-04-Restore-of-deleted-LVM-(Advanced).md&＃039;

    - &＃039;How to setup proxy to listen Spotify&＃039;: &＃039;2017-04-14-How-to-setup-proxy-to-listen-Spotify.md&＃039;

    - &＃039;SaltStack formulas&＃039;: &＃039;2017-04-12-SaltStack-Formulas-install.md&＃039;



# Copyright

copyright: &＃039;2016-2019 Anton Latukha, Creative Commons ShareAlike&＃039;





# Documentation and theme

theme:

  name: &＃039;material&＃039;

  palette:

    primary: &＃039;deep purple&＃039;

    accent: &＃039;deep purple&＃039;

  font:

    text: &＃039;Ubuntu&＃039;

    code: &＃039;Hack&＃039;

  icon:

    logo: &＃039;assets/images/favicon-min.png&＃039;

  logo: &＃039;assets/images/favicon-min.png&＃039;

  favicon: &＃039;assets/images/favicon-min.png&＃039;

  features:

    - tabs

    - instant



# Repository

repo_name: &＃039;Profile&＃039;

repo_url: &＃039;https://github.com/Anton-Latukha&＃039;

edit_uri: &＃039;/mkdocs-blog/tree/master/docs&＃039;

remote_name: &＃039;u&＃039;

remote_branch: &＃039;master&＃039;

# repo_name: &＃039;Site content on GitHub&＃039;

# repo_url: &＃039;https://github.com/Anton-Latukha/Anton-Latukha.github.io&＃039;



# Options

extra:

  social:

    - icon: octicons/mark-github

      link: &＃039;https://github.com/Anton-Latukha&＃039;

    - icon: &＃039;fontawesome/brands/gitlab&＃039;

      link: &＃039;https://gitlab.com/Anton.Latukha&＃039;

    - icon: &＃039;fontawesome/brands/twitter&＃039;

      link: &＃039;https://twitter.com/piroxiline&＃039;

    - icon: &＃039;fontawesome/brands/linkedin&＃039;

      link: &＃039;https://linkedin.com/in/anton-latukha-2a286690&＃039;

    - icon: &＃039;octicons/heart&＃039;

      link: &＃039;https://github.com/Anton-Latukha/Anton-Latukha.github.io/raw/master/assets/docs/AntonLatukhaCV.pdf&＃039;

    - icon: &＃039;octicon/download&＃039;

      link: &＃039;https://github.com/Anton-Latukha/Anton-Latukha.github.io/raw/master/assets/docs/AntonLatukhaCV.pdf&＃039;

    - icon: &＃039;fontawesome/brands/linux&＃039;

      link: &＃039;https://wiki.archlinux.org/index.php/Special:Contributions/Anton_Latukha&＃039;

    - icon: &＃039;fontawesome/brands/linux&＃039;

      link: &＃039;https://wiki.archlinux.org/index.php/Special:Contributions/PiroXiline&＃039;

  disqus: &＃039;blog-latukha-com&＃039;



# Extensions

markdown_extensions:

  - admonition    # summaries, notes, hints or warnings.

  - codehilite:    # Table of Contents extension

      guess_lang: false

      linenums: true

  - toc:

      permalink: true

  - pymdownx.arithmatex    # Parse LaTeX formulas

  - pymdownx.betterem    # improves the handling of emphasis markup

  - pymdownx.superfences    # ability to nest code blocks under blockquotes, lists and other block elements

  - pymdownx.inlinehilite    # support for inline code highlighting

  - pymdownx.smartsymbols    # converts markup for special characters into their corresponding symbols



plugins:

  - search

  - minify

  - htmlproofer


System information


  • OS: Latest Mkdocs-material Docker Python Alpine.

该提问来源于开源项目：squidfunk/mkdocs-material

Oh, I see, it is a "style" difference.


推荐阅读
author-avatar
mobiledu2502923673
这个家伙很懒，什么也没留下！
Tags | 热门标签
RankList | 热门文章
PHP1.CN | 中国最专业的PHP中文社区 | DevBox开发工具箱 | json解析格式化 |PHP资讯 | PHP教程 | 数据库技术 | 服务器技术 | 前端开发技术 | PHP框架 | 开发工具 | 在线工具
Copyright © 1998 - 2020 PHP1.CN. All Rights Reserved | 京公网安备 11010802041100号 | 京ICP备19059560号-4 | PHP1.CN 第一PHP社区 版权所有