Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/RavelloH/RTheme

新一代现代化极客风多功能横版静态博客主题框架 - 高性能/自动化/响应式/SEO友好/全站搜索/自动订阅更新/SPA/音乐播放器/原生实现/代码高亮/标签&分类自索引/语言&设置自定义/内置高级下载器/自动目录索引
https://github.com/RavelloH/RTheme

animation auto-feeder automation codehighlight compatibility customizable functionalization html5-framework javascipt javascript-applications music-player native native-base nodejs seo-friendly single-page-app spa static-site themes

Last synced: 22 days ago
JSON representation

新一代现代化极客风多功能横版静态博客主题框架 - 高性能/自动化/响应式/SEO友好/全站搜索/自动订阅更新/SPA/音乐播放器/原生实现/代码高亮/标签&分类自索引/语言&设置自定义/内置高级下载器/自动目录索引

Lists

README 

        



# RTheme - v3.0.0



新一代现代化极客风多功能横版静态博客主题框架  



// New generation modern geek style multifunctional horizontal static blog theme framework. //  



![GitHub last commit](https://img.shields.io/github/last-commit/RavelloH/RTheme?style=for-the-badge)

![GitHub repo size](https://img.shields.io/github/repo-size/RavelloH/RTheme?style=for-the-badge)

![GitHub Repo stars](https://img.shields.io/github/stars/RavelloH/RTheme?style=for-the-badge)



  

## 预览  



预览: [RavelloH's Blog](https://ravelloh.top/) / [备用](https://ravelloh.github.io/)



![Screenshot_20230819_163309_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/b83fe77d-82ad-4d96-a1ba-c26e69f4eb1f)

![Screenshot_20230819_163340_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/8dda9083-2096-47f7-a868-565fc53a8ece)

![Screenshot_20230819_163447_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/d96d3c0d-c98a-4fc3-835a-57f2020e7bf7)

![Screenshot_20230819_163646_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/293cb420-25a7-4b34-8900-b137f107c196)

![Screenshot_20230819_163712_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/ee264ec0-58c4-4169-a7c0-2febfabf5f93)

![Screenshot_20230819_163426_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/b38705ad-945e-4fd7-8ec6-93537ff52153)



## 特性  

### 高性能  

得益于重新设计的主题框架，主题现在在性能方面已经登峰造极，在Google PageSpeed Insights测试中取得了400/400的满分成绩。[测试结果](https://pagespeed.web.dev/analysis/https-ravelloh-top/ojuiwt9vbw?form_factor=desktop)

![Screenshot_20230819_162842_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/a3e71d29-29ef-4a48-b8f8-ad52f9df8240)  

在实际体验中，RTheme使用Web Worker异步处理高负载任务，异步加载/执行渲染，避免阻塞页面；其主动预加载也降低了页面的加载延迟。

在v3版本的全面升级中，主题已经改造为单页应用程序，加之顺畅的内容过渡，流畅性大大提升。



### 自动化  

RTheme使用Github Actions在云端自动部署，无需本地干预，即可自动完成索引更新、自动订阅更新、站点地图更新、文章旁路推荐等功能。  

此外，RTheme优化了自身的架构，使得其编写文章十分简单----仅需要了解HTML语法即可。你也可以选择使用Markdown编辑。之后，其组件将在渲染时自动无感添加。  

![Screenshot_20230817_200552_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/6e554c22-5a2f-45be-bc94-82ed845775a3)  



### 响应式  

主题使用响应式设计，基准元素均使用flex/grid布局，在各尺寸屏幕上表现出色。

![Screenshot_20230819_165401_com kiwibrowser browser](https://github.com/RavelloH/RTheme/assets/68409330/ba0071fb-8e4d-4c90-8834-203cb478a880)

![Screenshot_20230819_165820_com android chrome_edit_386275673794257](https://github.com/RavelloH/RTheme/assets/68409330/2dc5f1ee-9d84-4a7b-8aa9-d7cd6f6bdef8)



### 功能丰富  

主题功能丰富，内置设置/分享/在线音乐播放/多站点测速/自动全站搜索/文章自定义排序/文章标签&分类自动索引/站点地图/RSS/Atom自动生成/文章自动推荐/内置高级下载器/主动型预加载/用户登录接口/外链截图API等等一系列功能，创造出属于极客的极致主题框架。  



### 函数化  

主题中除了用于管控初始化加载的`loading.js`，其余脚本均将各功能包装为函数，以保证其可复用性及可免依赖乱序加载。  

![Screenshot_20230819_170439_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/2ffb3784-11ab-4326-9bd1-078d1ef17563)  

这使得二次开发十分简单，可直接复用主题框架中的功能。



### SEO友好  

主题自动根据页面内容生成两种格式的`sitemap`，优化搜索引擎抓取。  



### 全站搜索  

主题与可持续集成的RPageSearch深度集成，以提供静态站的全站高级搜索功能。

详见[RavelloH/RPageSearch](https://github.com/RavelloH/RPageSearch)。高性能/实时搜索/正则语法支持/异步/web worker/自动持续构建/可拓展数据格式，提供丰富的搜索功能。  

![Screenshot_20230812_214218_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/8244541c-c2c2-4893-a094-b49f2ac3d4fb)



### 自动订阅更新  

主题基于页面内容自动生成`RSS`、`Atom`、`JSON Feed`三种格式的订阅信息。



### 高兼容性  

主题最早支持到Chrome58(2017年4月19日),Firefox52(2017年3月7日),Opera45(2017年5月10日)，Safari，能够提供兼容性的保障。  

注：IE已死，不支持IE。



### 单页应用程序  

主题使用PJAX技术进行页面加载，并在页面加载切换之间加入过渡动画。  

另外，主题也会在页面加载时更新左下角的进度条，以展示正在加载/加载超时/加载完成/加载失败等不同场景。

![Screenshot_20230819_175635_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/160277fb-e8c1-4af9-9b3c-48c7bd23e9f0)



### 原生音乐播放器

主题内置原生音乐播放器，支持播放/切换/跳转/循环等功能，且可进行在线搜索以使用在线资源。  

![Screenshot_20230819_163646_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/293cb420-25a7-4b34-8900-b137f107c196)

也支持在文章内部加入音乐播放器，来调用主题的播放器进行播放。  

![Screenshot_20230819_180221_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/b8535362-58ad-4f37-8b44-2f3f206396c3)



### 过渡自然  

主题内置顺滑的元素切换函数`switchElementContext()`，以保证元素切换的顺滑自然。



### 轻量化&原生实现  

主题本体大小小于600KB，无任何框架，保证了其高速的加载性能。

![Screenshot_20230819_182143_com kiwibrowser browser](https://github.com/RavelloH/RTheme/assets/68409330/172c2488-40f4-4f4c-9f27-0ee93448c2ef)



### 代码高亮  

主题使用`highlight.js`代码高亮，并在其基础上使用Web Worker并行加载，防止页面阻塞。  

![Screenshot_20230819_182502_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/3c71231d-dd54-4b85-9fcf-4f1eb01097d8)



### 标签&分类自动索引

主题能自动根据文章信息索引具有相应标签/分类的文章，无需干预。

![Screenshot_20230819_182651_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/564e86cf-686b-4f05-9ebf-44f7d45e0af9)



### 语言自定义

主题的语言文件包单独成文件，你可以根据自己的需要更改模板，也可实现其国际化。

![Screenshot_20230819_182834_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/52fde86d-8136-4191-b90b-1a28653fb9bb)



### 设置自定义  

主题可进行各式设置，以提供个性化体验。  

设置项使用cookie存储，并且使用列表快速创建，保证其易用性。  

![Screenshot_20230819_183116_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/834ceb8e-fcdf-4404-b8df-76a6594f61ae)

![Screenshot_20230819_183151_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/4bf9efab-5b84-4777-a6e6-55af41c64ecd)



### 自动目录索引

主题可根据文章内标题自动生成目录，并高亮阅读项，以提高阅读体验。

![Screenshot_20230819_183406_com android chrome](https://github.com/RavelloH/RTheme/assets/68409330/33954e5b-c1e8-4e9a-a7d3-e4378e3b6b59)



### 文章旁路推荐

文章结尾自动推荐上一篇/下一篇文章，无需手动设置。效果见上方图片。



### 内置高级下载器

主题内置下载器，提高整体感。你可以在文章中使用。  

详阅[#箱式下载盒](https://ravelloh.top/articles/20230815/#%E7%AE%B1%E5%BC%8F%E4%B8%8B%E8%BD%BD%E7%9B%92)

![Screenshot_20230819_183617_com kiwibrowser browser](https://github.com/RavelloH/RTheme/assets/68409330/5d32c6bf-2b41-46b1-b898-09cb185e8ccd)



---



## 使用  

虽然此主题独立于其他任何静态博客生成器，不过作为标榜属于极客的主题，它使用模板化设计，你可以使用全局替换快速进行个性化配置。



> 参阅[#部署](https://ravelloh.top/articles/20230815/#部署)  

> 主题部署成功后，将包含一篇默认的Hello World的文章，其中包含语法示例与文章编发流程。



## 开发  

欢迎改进/修复/增加主题的功能。你可以使用nodejs在本地查看更改。

```shell

git clone https://github.com/RavelloH/RTheme

cd RTheme

npm install

npx http-server -c-1

```

另外，也可以直接运行RTheme的build流程

```shell

cd program

npm install

node search.js

node feed.js

node fileList.js

```



## 依赖  

主题依赖以下项目：  



[https://github.com/RavelloH/RPageSearch](https://github.com/RavelloH/RPageSearch)   

[https://github.com/RavelloH/markdown-it-api](https://github.com/RavelloH/markdown-it-api)  

[https://github.com/RavelloH/local-sitemap-generation](https://github.com/RavelloH/local-sitemap-generation)  

[https://github.com/RavelloH/local-sitemap-generation](https://github.com/RavelloH/local-sitemap-generation)  

[https://github.com/Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi)  

[https://github.com/instantpage/instant.page](https://github.com/instantpage/instant.page)  



此外，完整版还依赖以下项目：  



[https://github.com/RavelloH/umami-api-route](https://github.com/RavelloH/umami-api-route)  

[https://github.com/RavelloH/uptime-api-route](https://github.com/RavelloH/uptime-api-route)  

[https://github.com/umami-software/umami](https://github.com/umami-software/umami)  

[https://github.com/imaegoo/twikoo](https://github.com/imaegoo/twikoo)  



## Licence

MIT