目录

主题文档 - 使用LoveIt

#Hugo 主题 LoveIt Hugo - LoveIt 使用.

1.clone主题并更新配置

1
2
3
4
5
 1.git clone LoveIt到themes/目录
 2.修改config.tom配置,将LoveIt/sample的config.tom cp到base目录
 3.修改config.tom配置,去掉en对应的配置-否则需要中英文各写一篇

 vim themes/LoveIt/exampleSite/content/posts/theme-documentation-basics/index.zh-cn.md

2.官方文档

打开将LoveIt/sample页面: hugo server –source=exampleSite 依据官方文档配置 官方链接

3.其他tips

1
2
3
4
5
hugo serve --disableFastRender   --buildDrafts   -e production
draft开启,product可以开启comment等

社交链接参考: 图标等放在static下
可以自定义 browserconfig.xml 和 site.webmanifest 文件来设置 theme-color 和 background-color. static下

4.自定义样式

1
在 assets/css/_override.scss 中, 你可以覆盖 themes/LoveIt/assets/css/_variables.scss 中的变量以自定义样式.

5.搜索

1
    todo

content

6.内容组织

标签: - {{< admonition note “本地资源引用” >}} {{< /admonition >}}

文档: vim themes/LoveIt/exampleSite/content/posts/theme-documentation-content/index.zh-cn.md

本地资源引用

LoveIt 新增 | 0.2.10

有三种方法来引用图片音乐等本地资源:

  1. 使用页面包中的页面资源. 你可以使用适用于 Resources.GetMatch 的值或者直接使用相对于当前页面目录的文件路径来引用页面资源.
  2. 将本地资源放在 assets 目录中, 默认路径是 /assets. 引用资源的文件路径是相对于 assets 目录的.
  3. 将本地资源放在 static 目录中, 默认路径是 /static. 引用资源的文件路径是相对于 static 目录的.

引用的优先级符合以上的顺序.

在这个主题中的很多地方可以使用上面的本地资源引用, 例如 链接, 图片, image shortcode, music shortcode 和前置参数中的部分参数.

页面资源或者 assets 目录中的图片处理会在未来的版本中得到支持. 非常酷的功能!

7.前置参数

官方参考

8.摘要,默认提取,可手动设置

  • <!–more–>

9.markdown语法扩展


10.emoji

😄


11.公式

12.shortcut

shortcut官方

也可以style加入css控制

  1. style
  2. link
  3. image
  4. admonition
  5. mermaid
  6. echarts
  7. bilibili... mapbox

13.hugo获取资源,比如imag

hugo_image_res.png
官网链接
必须index开头的md才能获取当前目录的文件,否则应该放在全局 /asserts/images/下; 不过前置参数resource.name .image方式不能获取

posts下一个目录:如果有index.md只能有一个生效,父dir也不行 todo 页面资源仅仅可由页面包可以访问, 页面包就是一个根部包含index.md, 或者 _index.md文件的目录。资源仅仅与它们所属的最低层级的页面绑定。对于不包含index.md 的目录不附属任何资源。 参考

1
2
3
比如:   ![img](/images/huisu.png)
{{ $image := resources.Get "/images/huisu.png" }}
/images/huisu.png
Lighthouse (image)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
.
├── db
│   ├── index2.md --->如果是index,则当前目录及子目录只能渲染一个html
│   ├── libc.jpg
│   └── sqlite
│       ├── libc.jpg
│       ├── sqite2
│       │   └── index.md  ---> index.md理论上只应该放在最低层目录,且只有一个md
│       ├── x.md
│       └── xx.md
├── loveit
│   ├── featured-image.jpg
│   ├── hugo_image_res.png
│   └── index.md 
└── tpl.md

14.comment (未备案提示忽略)

1
2
3
4
5
    1.https://valine.js.org/quickstart.html 注册,然后F.; 会生成appid,key
    2.修改 vi themes/next/_config.yml ; 修改valine 开启true,把key加上
    3.最后!记得在Leancloud -> 设置 -> 安全中心 -> Web 安全域名 把你的域名加进去(域名按提示配置cname)
    4.可设置图像,到valine搜Avtar有详细说明,在评论时指定对应邮箱会自动更新图像
    5.valine不需要在域名里添加任何dns信息
1
2
3
4
    Tip: 
      购买域名后:'Code 403: 访问被API域名白名单拒绝,请检查的安全域名设置.
      最后一步,web安全域名加入,录入的api访问提示未备案可以忽略
      web安全域名:看浏览器显示的是什么加什么:比如https://www.feng1o.com; 没www不行

15.seo

参考

1
2
3
4
5
6
google:
    https://search.google.com/search-console/sitemaps?resource_id=https%3A%2F%2Ffeng1o.github.io%2F 将一个html放在static下,然后加入sitemap.xml

baidu:
   同样支持html,和sitemap提交(不可嵌套sitemap的xml,提交最低层的即可) 
   用的这个:https://feng1o.com/feng1o_domain/sitemap.xml

add 使用域名绑定,需要在域名管理和github的仓库设置里加入域名 参考 谷歌加新域名,sitemap 百度因为无法爬取github,顾需要使用vercel 参考

Tip: 使用域名绑定,需要在域名管理和github的仓库设置里加入域名 谷歌加新域名,sitemap 百度因为无法爬取github,顾需要使用vercel 参考

16.更新err

1
2
3
4
    a.new pc:
        failed to extract shortcode: template for shortcode "admonition" not found  --> theme/Loveit下的主题需要重新clone下
    b.hugo server #debug
    c.src doc in branch dev; and gen source in publich and then push to master branch。

17.记录

1
2
    a.archetypes/default.md     默认的文章模板, 可定制
    b.