Dev 1.6.4: Add and fix toc scroll event

.babelrc

@@ -1,5 +1,3 @@
 {
-  "presets": [
-    "@babel/preset-env"
-  ]
-}
+  "presets": ["@babel/preset-env"]
+}

.editorconfig

@@ -0,0 +1,19 @@
+# editorconfig.org
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.yml]
+trim_trailing_whitespace = false
+
+[*.ejs]
+indent_size = 4

.eslintrc.json

@@ -1,31 +1,23 @@
 {
-    "parser": "@babel/eslint-parser",
-    "extends": [
-        "alloy",
-        "plugin:prettier/recommended",
-        "prettier"
+  "parser": "@babel/eslint-parser",
+  "extends": ["alloy", "plugin:prettier/recommended", "prettier"],
+  "globals": {
+    "siteMeta": true
+  },
+  "env": {
+    "jquery": true
+  },
+  "plugins": ["prettier"],
+  "rules": {
+    "prettier/prettier": "error",
+    "no-unused-vars": [
+      "warn",
+      {
+        "vars": "all",
+        "args": "none",
+        "caughtErrors": "none"
+      }
     ],
-    "globals": {
-        "siteMeta": true
-    },
-    "env": {
-        "jquery": true
-    },
-    "plugins": [
-        "prettier"
-    ],
-    "rules": {
-        "prettier/prettier": "error",
-        "no-unused-vars": [
-            "warn",
-            {
-                "vars": "all",
-                "args": "none",
-                "caughtErrors": "none"
-            }
-        ],
-        "one-var": [
-            "off"
-        ]
-    }
-}
+    "one-var": ["off"]
+  }
+}

.prettierignore

@@ -1,2 +1,5 @@
 node_modules
-.DS_Store
+.DS_Store
+source
+_config.yml
+*.md

CHANGELOG.md

@@ -0,0 +1,74 @@
+# 更新日志
+
+## [v1.6.4](https://github.com/fi3ework/hexo-theme-archer/pull/307)
+
+- 新特性 / Feat
+
+  1. 现在可以设置主页的 Avatar 头像无边框了
+  2. 地址栏 Hash 值随文章页面滚动自动修改为对应的 Toc 值
+  3. 当 Toc 过长时，Toc 目录随文章页面滚动而[滚动](https://github.com/fi3ework/hexo-theme-archer/projects/1#card-64443923)
+  4. 添加对浮动元素的支持
+
+- 变更 / Change
+
+  1. 移动端的断点由 `980px` 修改为 `960px`
+  2. 点击文章页面 Toc 目录跳转时，强制显示 Banner，并预留出 Banner 的空间
+  3. 文章页面向上滚动显示 Banner 的阈值由 `500px` 修改为 `200px`
+
+- 修复 / Fix
+
+  1. 修复文章页面 License 处原文链接的中文分词不自动断行的[问题](https://github.com/fi3ework/hexo-theme-archer/issues/306#issuecomment-894640488)
+  2. 修复在某些页面下打开 Algolia 搜索时，页面可能显示异常的问题
+  3. 在尚未加载完成的情况下，不再错误显示侧边栏打开动画了
+  4. 修复文章页面 Toc 随页面滚动高亮显示错误的问题
+  5. 修复文章页中，浮动元素可能错误显示的问题（[#309](https://github.com/fi3ework/hexo-theme-archer/issues/309)）
+
+- 样式 / Style
+
+  1. 适配 Dark 模式下文章中表格的颜色
+  2. 优化 Dark 模式颜色配置
+  3. 优化 404 页面的样式
+  4. 优化文章页在移动端的显示
+
+- 性能 / Perf
+
+  1. 提高浏览器滚动性能
+
+- 其它 / Chore
+
+  1. 快速点击切换 Dark 模式按钮不再触发主题模式切换
+  2. 将更新日志内容放到 `CHANGELOG.md` 文件下，而不是 `README.md`
+
+- 开发者 / Dev
+
+  1. 提供 `source_version` 配置，一键修改源文件版本日期
+  2. 添加 `.editorconfig` 文件
+
+## v1.6.3 及更早版本
+
+- 2021.07.28 - 『添加 Dark 模式支持』
+- 2021.02.03 - 『添加“文章时效性”提示』
+- 2021.01.26 - 『更新使用的 nodejs，以及相关依赖包的版本』
+- 2020.03.04 - 『添加 utteranc 评论 支持』
+- 2020.03.02 - 『添加 Gitalk 评论 支持』
+- 2018.08.26 - 『添加 i18n 支持』
+- 2018.07.09 - 『可以切换深/浅色代码配色方案了，[详情](https://github.com/fi3ework/hexo-theme-archer/wiki/%E5%88%87%E6%8D%A2%E4%BB%A3%E7%A0%81%E9%85%8D%E8%89%B2%E6%96%B9%E6%A1%88)』
+- 2018.06.23 - 『添加 Valine 评论，感谢 [hulichao](https://github.com/fi3ework/hexo-theme-archer/issues/115) 同学』
+- 2018.06.04 - 『添加 Algolia 搜索，[详情](https://github.com/fi3ework/hexo-theme-archer/wiki/%E5%90%AF%E7%94%A8-Algolia-%E6%90%9C%E7%B4%A2)』
+- 2018.05.24 - 『可自定义访问量统计/增加字数统计及阅读时间』
+- 2018.05.01 - 『添加 license』
+- 2018.03.18 - 『添加 fancybox』
+- 2018.03.11 - 『toc 可以根据阅读位置自动展开和收缩了』
+- 2018.03.04 - 『头图的高度可以自定义了，配置 \_config 即可』
+- 2018.02.28 - 『重写分享功能，分享按钮在头图上』
+- 2018.02.24 - 『支持显示微信和 QQ 二维码』
+- 2018.02.04 - 『代码重构，性能优化，样式更新，V1.0.0』
+- 2017.12.27 - 『增加~~百度分享和~~页面浏览量统计』
+- 2017.12.17 - 『增加阅读进度条，在 post 页的顶部』
+- 2017.10.16 - 『修复移动端 bug，增加渐入效果』
+- 2017.10.05 - 『添加 toc，默认开启，可在配置中关闭』
+- 2017.09.30 - 『添加了 rss，修复了 placeholder 的 bug，更流畅』
+- 2017.09.25 - 『可以直接添加 disqus，gitment 了』
+- 2017.09.10 - 『添加了 about 页面』
+- 2017.08.26 - 『添加了二次开发文档，文章页 header 在下滑时隐藏』
+- 2017.08.17 - 『添加了置顶显示』

README.md

@@ -38,6 +38,11 @@ npm install hexo-wordcount --save
 git clone https://github.com/fi3ework/hexo-theme-archer.git themes/archer --depth=1
 ```
 
+如果您没有安装 Git 工具，也可以在 Hexo 根目录下手动创建 `themes/archer` 文件夹，然后将此仓库的源码放入该目录下。
+
+> 仓库的 `dev` 分支包含正在开发中的主题代码，如果您是**进阶开发者**或追新用户，能够承受代码的不足之处和低稳定性，并乐于关注我们开发的最新进展，也可以使用此分支：
+> `git clone -b dev https://github.com/fi3ework/hexo-theme-archer.git themes/archer --depth=1`
+
 ### 设置 Hexo 主题为 Archer
 
 修改 Hexo 根目录下的 `_config.yml` 文件中的 `theme` 字段为 `archer`：
@@ -262,18 +267,26 @@ z=\dfrac{3\pi}{2}(1+2t)\sin(\dfrac{3\pi}{2}(1+2t)), &
 
 ## 文章撰写增强
 
-Archer 主题为您撰写的文章提供了一些增强的展示内容，这需要您手动在文章的 Front-matter 处配置。包括如下：
+Archer 主题为您撰写的文章提供了一些增强的展示内容。
+
+请注意，这些增强的展示内容**仅保证**在 Archer 主题中能够顺利渲染显示。
+
+文章属性配置。在文章的 Front-matter 处配置：
 
 - [置顶文章](#置顶文章)
 - [隐藏文章目录](#隐藏文章目录)
 
+正文内容增强。在编写正文时根据自己的需要使用：
+
+- [浮动元素](#浮动元素)
+
 ### 置顶文章
 
 Archer 主题在主页为置顶的文章显示一个小标记。
 
 在默认情况下，Hexo 使用 [`hexo-generator-index`](https://github.com/hexojs/hexo-generator-index) 生成文章索引。假如您需要置顶某篇文章，只需要在它的 Front-matter 处添加 `sticky` 属性即可：
 
-```md
+``` md
 ---
 title: Hello World
 date: 2013/7/13 20:46:25
@@ -285,7 +298,7 @@ sticky: 100
 
 假如您使用其它的插件生成索引，也可以手动添加 `top` 属性以显示小标记：
 
-```md
+``` md
 ---
 title: Hello World
 date: 2013/7/13 20:46:25
@@ -299,22 +312,47 @@ top: true
 
 您可以通过配置 Archer 主题目录下的 `_config.yml` 以**全局**关闭文章目录：
 
-```yml
+``` yml
 toc: false
 ```
 
 或者，您也可以指定某些文章不显示目录。只需要在文章的 Front-matter 部分设置 `toc` 属性即可：
 
-```md
+``` md
 ---
 title: Hello World
 date: 2013/7/13 20:46:25
 toc: false
 ---
 ```
 
+当然，在全局关闭文章目录的情况下，您也可以在文章中手动设置 `toc: true`，以显示该文章的目录。
+
+### 浮动元素
+
+Archer 主题内置了对[浮动元素](https://developer.mozilla.org/zh-CN/docs/Web/CSS/float)的样式表支持。
+
+- `archer-float-left`：设置元素靠左浮动。
+- `archer-float-right`：设置元素靠右浮动。
+
+浮动元素仅在桌面端生效。在移动端中，浮动元素将恢复正常文档流。
+
+例如：
+
+``` md
+Nullam et orci eu lorem consequat tincidunt vivamus et sagittis magna sed nunc rhoncus condimentum sem. In efficitur ligula tate urna. Maecenas massa vel lacinia pellentesque lorem ipsum dolor.
+
+<div class="archer-float-right">
+  <img src="https://cdn.jsdelivr.net/gh/fi3ework/hexo-theme-archer/source/avatar/Misaka.jpg" alt="this is a float image!">
+</div>
+
+Nullam et orci eu lorem consequat tincidunt. Vivamus et sagittis libero. Nullam et orci eu lorem consequat tincidunt vivamus et sagittis magna sed nunc rhoncus condimentum sem. In efficitur ligula tate urna.
+```
+
 ## 更新主题
 
+主题的更新内容发布在仓库的 [Release](https://github.com/fi3ework/hexo-theme-archer/releases) 页面。
+
 提供两种方法供参考：
 
 - 使用 `git` 命令进行更新，但是可能需要手动合并代码，解决冲突；
@@ -330,34 +368,6 @@ toc: false
 
 首先备份 Archer 主题目录下所有您自定义过的文件（包括 `_config.yml` 和 `source` 文件夹下添加的文件等），然后删除 Archer 主题目录，再重新安装，最后将备份的文件替换到原来的位置即可。
 
-## 更新日志
-
-- 2017.08.17 - 『添加了置顶显示』
-- 2017.08.26 - 『添加了二次开发文档，文章页 header 在下滑时隐藏』
-- 2017.09.10 - 『添加了 about 页面』
-- 2017.09.25 - 『可以直接添加 disqus，gitment 了』
-- 2017.09.30 - 『添加了 rss，修复了 placeholder 的 bug，更流畅』
-- 2017.10.05 - 『添加 toc，默认开启，可在配置中关闭』
-- 2017.10.16 - 『修复移动端 bug，增加渐入效果』
-- 2017.12.17 - 『增加阅读进度条，在 post 页的顶部』
-- 2017.12.27 - 『增加~~百度分享和~~页面浏览量统计』
-- 2018.02.04 - 『代码重构，性能优化，样式更新，V1.0.0』
-- 2018.02.24 - 『支持显示微信和 QQ 二维码』
-- 2018.02.28 - 『重写分享功能，分享按钮在头图上』
-- 2018.03.04 - 『头图的高度可以自定义了，配置 \_config 即可』
-- 2018.03.11 - 『toc 可以根据阅读位置自动展开和收缩了』
-- 2018.03.18 - 『添加 fancybox』
-- 2018.05.01 - 『添加 license』
-- 2018.05.24 - 『可自定义访问量统计/增加字数统计及阅读时间』
-- 2018.06.04 - 『添加 Algolia 搜索，[详情](https://github.com/fi3ework/hexo-theme-archer/wiki/%E5%90%AF%E7%94%A8-Algolia-%E6%90%9C%E7%B4%A2)』
-- 2018.06.23 - 『添加 Valine 评论，感谢 [hulichao](https://github.com/fi3ework/hexo-theme-archer/issues/115) 同学』
-- 2018.07.09 - 『可以切换深/浅色代码配色方案了，[详情](https://github.com/fi3ework/hexo-theme-archer/wiki/%E5%88%87%E6%8D%A2%E4%BB%A3%E7%A0%81%E9%85%8D%E8%89%B2%E6%96%B9%E6%A1%88)』
-- 2018.08.26 - 『添加 i18n 支持』
-- 2020.03.02 - 『添加 Gitalk评论 支持』
-- 2020.03.04 - 『添加 utteranc评论 支持』
-- 2021.01.26 - 『更新使用的 nodejs，以及相关依赖包的版本』
-- 2021.02.03 - 『添加“文章时效性”提示』
-
 ## 许可证
 
 MIT

_config.yml

@@ -36,6 +36,29 @@ friends:
 about:
   enable: true
   image: '/intro/about-bg.jpg'
+# Search for website
+search:
+  enable: false
+  # Seach URL, must be set. For example: 'fi3ework.github.io'
+  url: 
+  # Search engine: 'bing' (default), 'google' or 'baidu'
+  engine: bing
+# Display icons of friends, about and search
+# You can only use free icons started with 'fab' and 'fas' by default
+# https://fontawesome.com/v5.15/icons?d=gallery&p=2&s=brands,solid&m=free
+profile_icons:
+  enable: false
+  friends: 'fas fa-heart'
+  about: 'fas fa-id-card'
+  search: 'fas fa-search'
+# Additional profile links
+profile_links:
+  # - name: GOOGLE
+  #   url: //www.google.com
+  #   icon: 'fab fa-google'
+  # - name: GALLERY
+  #   url: //www.unsplash.com
+  #   icon: 'fas fa-images'
 
 # ========== Site ========== #
 # title of the site (good for SEO)
@@ -57,13 +80,28 @@ post_header_image: '/intro/post-bg.jpg'
 _404_image: '/intro/404-bg.jpg'
 
 # ========== Theme ========== #
+# Truncate length of abstracts in index page (the default is 300, there will be no abstruct if you input 0)
+truncate_length: 300
+# Show read more button if using excerpt or abstract to display abstracts in index page
+read_more_button: false
+# Enable toc
+toc: true
+# Word count & Reading time
+reading_info: true
+# Intro height (the default is 50 percents of the screen, you can input other number)
+index_intro_height: 50
+post_intro_height: 50
+about_intro_height: 50
 # Blog float button theme ('default' or 'rounded')
 float_button_theme: default
 # Blog read progress color ('default' for black or 'feature' for feature-color)
 read_progress_color: default
 # Blog post banner theme ('default' or 'clean')
 post_banner_theme: default
+# Display profile avatar's border
+avatar_border: true
 # Stick profile info
+# Keep false if you have too many profile links
 profile_sticky: false
 # Show categories info in index and post page
 show_categories: false
@@ -127,19 +165,9 @@ google_analytics:
 CNZZ_analytics: 
 
 # ========== Others ========== #
-# favicon
+# Favicon
 favicon: /assets/favicon.ico
-# truncate length of abstracts in index page (the default is 300, there will be no abstruct if you input 0)
-truncate_length: 
-# enable toc
-toc: true
-# word count & reading time
-reading_info: true
-# intro height (the default is 50 percents of the screen, you can input other number)
-index_intro_height: 50
-post_intro_height: 50
-about_intro_height: 50
-# copyright
+# Post copyright
 copyright:
   enable: true
   # https://creativecommons.org/
@@ -172,3 +200,8 @@ math:
     # Specified version number no less than '3.0.0', or you need to modify the CDN link manually.
     # Version number '3' is for the latest '3.x' version of MathJax.
     version: 3.2.0
+
+# ========== Theme Dev ========== #
+# Ensure visitor to get the latest version of source.
+# Set a higher value before creating new release.
+source_version: 20210811

languages/default.yml

@@ -4,4 +4,5 @@ author: 原文作者
 post_link: 原文链接
 publish_date: 发表日期
 update_date: 更新日期
-license: 版权声明
+license: 版权声明
+read_more: 阅读全文