Problem description
勉勉强强都看懂大部分，还是有点吃力。开发者都是**人，是不是保留一份中文文档更好点。

Environment and configuration

• Python Version:
• pip Version:

Additional information

md生成的目录可以在github上面正常显示和跳转，但网页上不能正常跳转。

目录的HTML
<a href="#css">CSS</a>

对应的小节标题的HTML
<h2>CSS</h2>

<h2>CSS</h2>没有设置id，所以目录不能正常跳转。

该怎么写md或设置？

谢谢

yaml.scanner.ScannerError: mapping values are not allowed here
  in "<unicode string>", line 4, column 5:
    tags:

以上是报错信息,":"是半角的啊

想要使用 MetingJS 做一个音乐页面，因为 MetingJS 提供了 CDN 引入，可以直接在 head 标签里引入。

所以 page 的 excerpt 字段是否可以直接解析到 head 里，如：

excerpt: <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/aplayer/dist/APlayer.min.css">
<script src="https://cdn.jsdelivr.net/npm/aplayer/dist/APlayer.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/meting@2/dist/Meting.min.js"></script>

然后正文里：

<meting-js server="netease" type="playlist" id="#">

目前我是直接在正文里插入以上两段代码，播放器加载是稍慢的，不是很优雅==

复现： --build_dir ./dist/ 改为 --build_dir ./dist

Problem description
想知道，这个小工具是否可以直接使用Hexo的主题？

Environment and configuration

• Python Version:
• pip Version:

Additional information

您好，生成的sitemap文件内URL只包含页面路径不包含域名，不被google serach console识别

目前的生成格式如下：

<url>
<loc>/Maverick/about/</loc>  # 这里没有包含域名
<lastmod>2017-06-28</lastmod>
<changefreq>always</changefreq>
<priority>0.8</priority>
</url>

可能需要的格式为：

<url>
<loc>https://alandecode.github.io/Maverick/about/</loc>  # 这里包含了域名
<lastmod>2017-06-28</lastmod>
<changefreq>always</changefreq>
<priority>0.8</priority>
</url>

感谢您的辛苦付出，祝安好！

Actual behavior

Valine does not load after first PJAX switch in Kepler theme, loads as normal after refresh or more PJAX switch.

Expected behavior

Should load as normal.

How to reproduce

https://wiki.imalan.cn

Environment and configuration

Not important.

Error log

Additional information

git clone https://github.com/AlanDecode/Maverick.git ./Maverick && cd ./Maverick

上面的https改成git就好了

本来就是因为简书没有TOC就想搬家，然后干脆做独立博客算了，了解到Maverick很酷的资源加载方式就用在了这个项目上，结果发现主题不支持TOC，我另一个博客用hexo搭建的，发现里面大部分主题是有TOC的，会否继续支持？

主题制作规范有没有吖？

➜ Maverick git:(master) ✗ python ./build.py
Traceback (most recent call last):
File "./build.py", line 9, in
from Maverick.Utils import print_color, Color
File "/root/RemoteWorking/Maverick/Maverick/Utils.py", line 28
def print_color(text: str, fg: Color = Color.BLACK.value, end='\n'):
^
SyntaxError: invalid syntax

Actual behavior

较复杂度LaTeX公式无法解析。

Expected behavior

正确解析公式。

How to reproduce

下面两个公式均无法正常解析：

1. 行内公式
   $f(i)=max\{f(j)|j<i,a_j<a_i\}+1$
   原因：虽然正确解析，但是<导致网页中公式解析失败。
2. 行间公式

   $$
   \begin{aligned}
   \dot{x}&=\sigma(y-x)\\
   \dot{y}&=\rho x-y-xz\\
   \dot{z}&=-\beta z+xy
   \end{aligned}
   $$
   

   原因：在解析之后行末代表换行的双反斜杠\\变成了\，也就是变成了如下所示：

   $$
   \begin{aligned}
   \dot{x}&=\sigma(y-x)\
   \dot{y}&=\rho x-y-xz\
   \dot{z}&=-\beta z+xy
   \end{aligned}
   $$
   

Environment and configuration

使用的是commitid为d1572bd9a47f9a920c32268697b4b8a19602bf7d的Maverick，即大佬您Wiki中使用的版本。

主题为latest分支的Kepler（但是我感觉该问题应该和主题无关QAQ）。

演示链接中的第三行可以看到错误的解析。

Additional information

我尝试过解决，但是没能完全解决。

上述行内公式由于<的问题网页中解析失败可以通过修改Maverick/Maverick/Markdown.py文件164行MathRendererMixin中所有text为mistune.escape(text)来转义解决。

上述行间公式解析错误我感觉应该是mistune解析把双反斜杠吃掉了，但是因为我基本不会python所以没能解决问题QAQ。

希望大佬有空的时候研究一下。

顺便，由衷感谢大佬写的解析器和主题QwQ。

i follow your guide and succesfully setting the command but it have 1 world dunno which part i do wrong .

Problem description
Which Markdown editor you used in this project?

Because it involves the theme and "site_prefix" settings, it feels very difficult to get it right in one step. I built a python3 bundled simple http server, but resulting in the "target" of each link being "_blank". Nginx works fine, but it is hard for migration.

I find another project called [markdown-diary] (https://github.com/dcervenkov/markdown-diary.git), and I felt it was pretty good . Would it possible to create a UI based on Python environment.

请问本地编辑器怎么配置比较好？

因为涉及到主题和site_prefix的设置，如果想一步到位感觉挺难的。我自己搞了一个python3自带的simple http server，结果估计是单线程的server，导致每个链接的target都是”_blank“。用nginx感觉迁移起来挺费事。

我还看了一个叫markdown-diary的项目，感觉也挺好的，之后希望能搞一个基于python的ui出来

Environment and configuration

• Python Version: 3.9.1
• pip Version: 20

Additional information

Is there any plan on supporting Notion as data source like https://github.com/mayneyao/gine-blog

最近这个似乎是个趋势，有更新的打算吗

_{Sent from PPHub}

Problem description

1. 标签中只有 /，无法解析出原文链接
2. 文章内图片无法显示
   以上问题只存在 iOS 平台的 RSS Reader Prime 中，是一个本地阅读器。在 Feedly 中以上问题会被自动优化。
   

Environment and configuration
iOS 平台的 RSS Reader Prime

• Python Version: 3.7
• pip Version:

我的conf.py： https://github.com/luhexyz/site-Blog/blob/master/conf.py
测试过我自己和您的 RSS 链接，以上问题依然存在。
（唯一的区别在于我的头像无法显示，您的头像可以显示，应该是因为我没开 jsdelivr 的缘故）

Additional information
我的图片是使用图床链接插入的，没有配置过 fetch_remote_imgs

举例如下：

如果写下面这种嵌套：

直接从 GitHub 上 Preview 这段文字，内部的 Markdown 格式会正确显示：

但是生成的网页上看起来会是这样：

从生成的 html 里看，其内部的 Markdown 没有被正确地表达：

更换了几个主题，发现最终生成的效果都是一样，应该和主题没什么关系。

Site prefix: /
Source dir: /root/app/Maverick/test_src/
Build dir: ./test_dist/
Start clean...done.
Loading contents...
Traceback (most recent call last):
  File "build.py", line 43, in <module>
    main(sys.argv[1:])
  File "build.py", line 39, in main
    builder.build_all()
  File "/root/app/Maverick/Maverick/Builder.py", line 142, in build_all
    content = Content(content_path)
  File "/root/app/Maverick/Maverick/Content.py", line 33, in __init__
    self.meta = Metadata(yaml.safe_load(m.group(1)))
  File "/root/app/Maverick/Maverick/Metadata.py", line 17, in __init__
    self["date"] = moment.date(str(fr.get("date", ""))).locale(g_conf.locale)
  File "/usr/local/lib/python3.6/site-packages/moment/core.py", line 67, in locale
    self._date = pytz.timezone(zone).normalize(self._date)
  File "/usr/local/lib/python3.6/site-packages/pytz/tzinfo.py", line 252, in normalize
    offset = dt.tzinfo._utcoffset
AttributeError: 'StaticTzInfo' object has no attribute '_utcoffset'

_{Sent from PPHub}

我在本地多使用 typora ，画的 mermaid 图也比较多。希望能支持:smiley:

这个搜索感觉很好，能不能简单说说实现过程呢？感觉跟Icarus很像。

我是在D:\project\GitHub\Maverick下直接Git Bash here执行的

Actual behavior
每次在本地build之后，推送到master，然后调用action构建，再自动推送到gh分支之后，自定义域名都会失效，不知道如何解决？

Expected behavior

How to reproduce

Environment and configuration

• Python Version:
• pip Version:

Error log

Additional information

Actual behavior
In both RSS 2.0 xml and Atom 1.0 xml files, the logo field remains ${static_prefix}logo.png, instead of being parsed as /logo.png

How to reproduce
Open either /feed/index.xml or /feed/atom/index.xml

Environment and configuration
Maverick 1.1

• Python Version: 3.7.5
• pip Version: 19.3.1

Problem description
···
Start _build_feed...Traceback (most recent call last):
File "c:\Users\Sky Qin\Documents\Wiki\Maverick\build.py", line 43, in
main(sys.argv[1:])
builder.build_all()
File "c:\Users\Sky Qin\Documents\Wiki\Maverick\Maverick\Builder.py", line 173, in build_all
self._template.render(self._config, self._posts, self.pages)
File "c:\Users\Sky Qin\Documents\Wiki\Maverick\Templates\Kepler_init.py", line 19, in render
Kepler(conf, posts, pages)()
File "c:\Users\Sky Qin\Documents\Wiki\Maverick\Maverick\Template.py", line 158, in call
self._build_feed()
File "c:\Users\Sky Qin\Documents\Wiki\Maverick\Maverick\Utils.py", line 42, in wrapper
func(*args, **kwargs)
File "c:\Users\Sky Qin\Documents\Wiki\Maverick\Maverick\Template.py", line 91, in _build_feed
fg.rss_file(unify_joinpath(self._config.build_dir, 'feed/index.xml'))
File "C:\Users\Sky Qin\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.8_qbz5n2kfra8p0\LocalCache\local-packages\Python38\site-packages\feedgen\feed.py", line 415, in rss_file
feed, doc = self._create_rss(extensions=extensions)
File "C:\Users\Sky Qin\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.8_qbz5n2kfra8p0\LocalCache\local-packages\Python38\site-packages\feedgen\feed.py", line 267, in _create_rss
raise ValueError('Required fields not set (%s)' % missing)
ValueError: Required fields not set (title)
···
Environment and configuration

• Python Version: 3.7
• pip Version: 20.0.2

配置皆为默认。

Additional information
在此之前，会出现无法从github使用git命令克隆主题的问题：
···
Site prefix: /
Source dir: c:\Users\Sky Qin\Documents\Wiki\Maverick/test_src/
Build dir: ./test_dist/
Start clean...done.
Loading contents...
Contents loaded.
Start setup_theme...
fatal: Too many arguments.

usage: git clone [] [--] [

Sometimes I want to post with music in it, and Maverick only supports videos (DPlayer).

环境：Ubuntu 18.04, pip 9.0.1, nginx 1.14.0, python 3.6.9
nginx 仅修改默认配置的 loaction，其余无变化
将主题文件（Galileo）下载到本地，设置主题路径
访问网站时出现主页加载资源404 情况，查看index.html 发现请求 /assert/.css or /assert/.js，但网站目录中所需文件在 /assert/css/* or /assert/js/* 等，请问可能是出现了什么问题，如何解决

update

更换为在线获取主题后，成功加载
预计是本地主题应用的问题
我将 Galileo 主题下载并放到 Maverick/theme 目录下，在 config.py 中做如下设置

template = {
    "name": "Galileo",
    "type": "local",
    "path": "theme/"
}

update

如果采取 readme 中的目录格式

/some/path/to/MyTheme/
	__init__.py

template = {
    "name": "MyTheme",
    "type": "local",
    "path": "/some/path/to/MyTheme/" # could also use relatetive path to Maverick
}

那么将会报错 No module named 'MyTheme' ，故当前设置为：

/some/path/to/MyTheme/
	__init__.py

template = {
    "name": "MyTheme",
    "type": "local",
    "path": "/some/path/to/"
}

仍有无法加载资源问题

如题，怎么更新内置Valine评论样式或版本
好像是固定的

Actual behavior
如题

Expected behavior
正常编译

How to reproduce
将文章中 status 改为 hidden，（另外发现删除文章也会报错，将删除的文章放回原来位置又可以正常编译）

# -*- coding: utf-8 -*-
"""博客构建配置文件
"""

# For Maverick
site_prefix = "/"
source_dir = "../src/"
build_dir = "../dist/"
index_page_size = 10
archives_page_size = 20
category_by_folder = True
# fetch_remote_imgs = True

template = {
    "name": "Galileo",
    "type": "local",
    "path": "../Galileo"
}

enable_jsdelivr = {
    "enabled": True,
    "repo": "linsyorozuya/Blog@gh-pages"
}

# 站点设置
site_name = ""
site_logo = "${static_prefix}logo.png"
site_build_date = "2020-01-11T12:00+08:00"
author = ""
email = ""
author_homepage = ""
description = ""
key_words = ['Maverick', 'Galileo', 'blog']
language = 'zh-CN'
external_links = [
    {
        "name": "Maverick",
        "url": "https://github.com/AlanDecode/Maverick",
        "brief": "🏄‍ Go My Own Way."
    },
    {
        "name": "三無計劃",
        "url": "https://www.imalan.cn",
        "brief": "熊猫小A的主页。"
    }
]
nav = [
    {
        "name": "首页",
        "url": "${site_prefix}",
        "target": "_self"
    },
    {
        "name": "归档",
        "url": "${site_prefix}archives/",
        "target": "_self"
    },
    {
        "name": "关于",
        "url": "${site_prefix}about/",
        "target": "_self"
    }
]

social_links = [
    {
        "name": "Twitter",
        "url": "https://twitter.com/linsyorozuya",
        "icon": "gi gi-twitter"
    },
    {
        "name": "GitHub",
        "url": "https://github.com/linsyorozuya",
        "icon": "gi gi-github"
    },
    {
        "name": "Weibo",
        "url": "https://weibo.com/2630651323/",
        "icon": "gi gi-weibo"
    }
]

head_addon = r'''
<meta http-equiv="x-dns-prefetch-control" content="on">
<link rel="dns-prefetch" href="//cdn.jsdelivr.net" />
'''

footer_addon = ''

body_addon = ''

# 评论设置
valine = {
    "enable": True,
    "el": '#vcomments',
    "appId": "eMmVkL0FDqrmunWuz9m5sBGn-gzGzoHsz",
    "appKey": "RsDa5XAzjj8cWQLigV7YezRM",
    "visitor": True,
    "recordIP": True
}

Error log

  File "./build.py", line 43, in <module>
121
    main(sys.argv[1:])
122
  File "./build.py", line 39, in main
123
    builder.build_all()
124
  File "/home/runner/work/Blog/Blog/Maverick/Maverick/Builder.py", line 173, in build_all
125
    self._template.render(self._config, self._posts, self._pages)
126
  File "/home/runner/work/Blog/Blog/Galileo/__init__.py", line 22, in render
127
    Galileo(conf, posts, pages)()
128
  File "/home/runner/work/Blog/Blog/Maverick/Maverick/Template.py", line 158, in __call__
129
    self._build_feed()
130
  File "/home/runner/work/Blog/Blog/Maverick/Maverick/Utils.py", line 42, in wrapper
131
    func(*args, **kwargs)
132
  File "/home/runner/work/Blog/Blog/Maverick/Maverick/Template.py", line 91, in _build_feed
133
    fg.rss_file(unify_joinpath(self._config.build_dir, 'feed/index.xml'))
134
  File "/opt/hostedtoolcache/Python/3.7.5/x64/lib/python3.7/site-packages/feedgen/feed.py", line 416, in rss_file
135
    feed, doc = self._create_rss(extensions=extensions)
136
  File "/opt/hostedtoolcache/Python/3.7.5/x64/lib/python3.7/site-packages/feedgen/feed.py", line 375, in _create_rss
137
    item = entry.rss_entry()
138
  File "/opt/hostedtoolcache/Python/3.7.5/x64/lib/python3.7/site-packages/feedgen/entry.py", line 220, in rss_entry
139
    else self.__rss_content['content']
140
  File "src/lxml/etree.pyx", line 1025, in lxml.etree._Element.text.__set__
141
  File "src/lxml/apihelpers.pxi", line 734, in lxml.etree._setNodeText
142
  File "src/lxml/apihelpers.pxi", line 722, in lxml.etree._createTextNode
143
  File "src/lxml/apihelpers.pxi", line 1527, in lxml.etree._utf8
144
ValueError: All strings must be XML compatible: Unicode or ASCII, no NULL bytes or control characters
145
Start _build_feed...
146
##[error]Process completed with exit code 1.

Problem description

Environment and configuration

• Python Version:
• pip Version:

Additional information
我希望用vimwiki来组织 但是我发现,Maverick所生成的链接都是"/blog/archives/"的 但vimwiki的语法都是绝对路径,所以无法用于vimwiki所以我希望支持vimwiki的链接格式

For Chinese system language users:
在 控制面板-区域-更改系统区域设置 中
勾选 Beta版：使用 Unicode UTF=8 提供全球语言支持(U) 选项
重启电脑后，就可以安装了。

Problem description

因为是静态html，也不是用了加密，hidden文章是不是任何访客都无法访问？

Environment and configuration

• Python Version:
• pip Version:

Additional information

Problem description
body中.container的max-width: 660px;感觉有点小，有办法可以修改吗

Environment and configuration

• Python Version:
• pip Version:

Additional information

Problem description
第一次在root目录下安装maverick，可以运行没报错，后来用webdav挂载了坚果云， Config修改为源目录为webdav挂载的坚果云后报错了，权限没问题，也都是build feed 出错，重装maverick到www目录，修改了权限也是build feed出错，运行日志中的source 也不是config中的/www/maverick/diary 而是默认的/www/maverick/test_src/ 不知道哪出了问题。

Environment and configuration
Ubuntu 20.10 (GNU/Linux 5.8.0-38-generic x86_64)
Python 3.8.6
pip 20.1.1 from /usr/lib/python3/dist-packages/pip (python 3.8)

**报错日志
root@vultr:~# python /www/maverick/build.py
Site prefix: /
Source dir: /www/maverick/test_src/
Build dir: ./test_dist/
Start clean...done.
Loading contents...
Contents loaded.
Start setup_theme...
done.
Start build_search_cache...
Sizeinfo hit cache: ./assets/2934349b033b5bb5a19efc7233d3d539b700bcf5.jpg (836, 450)
Sizeinfo hit cache: ./assets/IMG_0073.jpeg (4032, 2688)
Sizeinfo hit cache: ./assets/1463017562.jpg (2690, 2688)
Sizeinfo hit cache: ./assets/IMG_0053.jpeg (4032, 2688)
Sizeinfo hit cache: ./assets/IMG_0039.jpeg (4032, 2688)
Sizeinfo hit cache: ./assets/IMG_0051.jpeg (4032, 2688)
Sizeinfo hit cache: ./assets/IMG_0005.jpeg (4032, 2688)
done.
Start build_posts...
Finished: Overview of Maverick
Finished: Typography
done.
Start build_pages...
Finished: About
done.
Start build_index...done.
Start build_archives...done.
Start build_categories...done.
Start build_tags...done.
Start _build_static...done.
Start _build_feed...Traceback (most recent call last):
File "/www/maverick/build.py", line 43, in
main(sys.argv[1:])
File "/www/maverick/build.py", line 39, in main
builder.build_all()
File "/www/maverick/Maverick/Builder.py", line 173, in build_all
self._template.render(self._config, self._posts, self._pages)
File "/www/maverick/Templates/Galileo/init.py", line 22, in render
Galileo(conf, posts, pages)()
File "/www/maverick/Maverick/Template.py", line 158, in call
self._build_feed()
File "/www/maverick/Maverick/Utils.py", line 42, in wrapper
func(*args, **kwargs)
File "/www/maverick/Maverick/Template.py", line 91, in _build_feed
fg.rss_file(unify_joinpath(self._config.build_dir, 'feed/index.xml'))
File "/usr/local/lib/python3.8/dist-packages/feedgen/feed.py", line 415, in rss_file
feed, doc = self._create_rss(extensions=extensions)
File "/usr/local/lib/python3.8/dist-packages/feedgen/feed.py", line 267, in _create_rss
raise ValueError('Required fields not set (%s)' % missing)
ValueError: Required fields not set (title)
**

• Python Version: 3.8.6
• pip Version: 20.1.1

-- coding: utf-8 --

"""Sample Configuration
"""

For Maverick

site_prefix = "/"
source_dir = "/www/maverick/diary/"
build_dir = "/www/wwwroot/blog/"
template = "Galileo"
index_page_size = 10
archives_page_size = 30
fetch_remote_imgs = True
enable_jsdelivr = {
"enabled": False,
"repo": "AlanDecode/Maverick@gh-pages"
}
locale = "Asia/Shanghai"
category_by_folder = False
Additional information

正在fork示例并跟随学习中

有看到template有个default的主题，想问下大佬有办法自订或者引用github pages里面的主题吗？

Thanks for reading

如题，在添加了CNAME也无用，只好每次设置，请问这个如何解决呢，感谢

本来不是个问题，哪个版本都能用，无奈Leancloud华东节点的域名https://tab.avoscloud.com停止支持了，证书过期导致Valine评论异常（偶尔加载不出，或者左上角显示不安全）。
Valine作者表示下个版本修复（https://github.com/xCss/Valine/issues/320）
翻了下Valine文档没找到如何升级的描述，所以来这边问一下。