Skip to content

Commit

Permalink
Update README, ready to publish
Browse files Browse the repository at this point in the history
  • Loading branch information
apqx committed Nov 29, 2023
1 parent 8f89140 commit 8201839
Show file tree
Hide file tree
Showing 13 changed files with 263 additions and 14,695 deletions.
95 changes: 32 additions & 63 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,110 +1,79 @@
# 立泉の写字板

这是一个基于`Jekyll`的开源[博客](https://mudan.me)示例,遵循[Material Design](https://material.io)设计规范,使用`Google`[Material components web](https://github.com/material-components/material-components-web)组件库。
一个基于[Jekyll](https://jekyllrb.com)[Material Design](https://material.io)开源博客,使用`Google`提供的[Material Components Web](https://github.com/material-components/material-components-web)组件库。

淡雅极简风,文字、色彩、动画之外不添加多余元素,这也是我自己的博客
这是我自己的博客网站,它并非通用`Jekyll`模版,而是包含了太多我个人倾向的私人分享空间,淡红色极简风,文字、色彩、动画之外不添加多余元素,可以把它当作一个使用`Material Design`的个人站参考

博文使用`Markdown`格式撰写,由`Jekyll`将其按照指定的方式转换为`HTML`网页,生成一个静态站点,可以托管在[GitHub Pages](https://pages.github.com)或更灵活的云服务器上。
博客链接 👉 [立泉の写字板](https://mudan.me)

![立泉の写字板](https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/screenshot_index.webp)

博文使用`Markdown`格式撰写,由`Jekyll`将其按指定方式转换为`HTML`网页,生成静态站点,可以托管在[GitHub Pages](https://pages.github.com)或更灵活的云服务器上。

![立泉の写字板](https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/screenshot_essay_phone.webp)

# 本地调试

切换到内部的`npm`工程目录,构建生成所需的`js``css`文件:
首先切换到内部`webpack`工程目录,构建所需的`js``css`文件:

```sh
# 进入内部npm工程
# 进入内部webpack工程
cd npm
# 安装所需依赖
npm install
# 构建,在/npm/dist/目录下生成js和css
# 在/npm/dist/目录下生成js和css
npm run build
```

`_includes/head-common.html`中定义着网站使用的`js``css`,它们由内部的`npm`工程生成,为提高访问速度而被托管到阿里云`OSS`上。
`_includes/head-common.html`中定义着网站使用的`js``css`资源,它们由内部`webpack`工程生成,为提高访问速度而被托管到阿里云`OSS`上。

本地调试时,需要修改这些资源为本地文件以实时响应`npm`工程的变化
本地调试时,需要进入`debug`模式使用上面👆生成的本地资源以实时响应`webpack`工程变化

```html
<!-- _includes/head-common.html -->

<!-- css和js文件由内部的npm工程输出 -->
<!-- only for test -->
<link rel="stylesheet" href="/npm/dist/apqx.v[version].css" />
<script type="text/javascript" src="/npm/dist/apqx.v[version].js"></script>
<link rel="stylesheet" href="/css/materialFontsIcons.css" />

<!-- 这里用Jekyll的Liquid模版语言隐藏掉这段指向阿里云托管的外部资源的代码 -->
{% comment %}
<!-- for publish -->
<link rel="stylesheet" href="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/apqx.v[version].css" />
<script type="text/javascript" src="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/apqx.v[version].js"></script>
<link rel="stylesheet" href="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/materialFontsIcons.css" />
<!-- Global site tag (gtag.js) - Google Analytics -->
<!-- close it when on test -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-GDLCDFZXBF"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag() { dataLayer.push(arguments); }
gtag('js', new Date());
gtag('config', 'G-GDLCDFZXBF');
</script>
{% endcomment %}
<!-- 设置debug为true,将会使用本地资源 -->
{% assign debug = true %}
```

安装[Jekyll](https://jekyllrb.com/docs/installation/macos/),启动本地服务:
安装[Jekyll](https://jekyllrb.com/docs/installation/macos/),启动本地服务:

```sh
# 安装jekyll,macOS使用home-brew
# 安装jekyll,macOS使用Homebrew
brew install jekyll
# 安装定义在_config.yml中的jekyll插件
# 安装config.yml中定义的jekyll插件
bundle install
# 启动jekyll服务,同时自动调用浏览器打开http://localhost:4000
# 启动jekyll服务
# 同时自动调用浏览器打开http://localhost:4000进入博客
bundle exec jekyll serve -l -o
```

`Jekyll`会在`_site/`目录下生成一个由静态`HTML`页面构成的网站源码,浏览器访问本地`4000`端口就可以看到这个博客网站了。
`Jekyll`会在`_site/`目录下生成一个由`HTML`页面构成的静态网站,并`serve`到本地4000端口,通过这个👇链接访问:

`http://localhost:4000`
```sh
http://localhost:4000
```

# 部署到GitHub Pages

对于部署到[GitHub Pages](https://pages.github.com)的情况,因为中国大陆的访问速度受限,一般会把`HTML`网页之外的资源托管到大陆的云平台上以提高国内访问速度,比如阿里云的`OSS`对象存储服务。
因为[GitHub Pages](https://pages.github.com)在中国大陆受限,所以一般会把`HTML`页面里的资源托管到大陆的云平台上以提高国内访问速度,比如阿里云的`OSS`对象存储服务。如果域名已备案也可以再叠一层`CDN`加速

本地调试完成后,如果`npm`工程生成了新的`js``css`文件,需要更新阿里云`OSS`托管的旧文件,修改`_includes/head-common.html`以使用这些云端托管的资源
本地调试完成后,如果`webpack`生成了新的`js``css`,需要上传到`OSS`托管,然后修改`_includes/head-common.html`关闭`debug`模式即可使用这些托管的资源

```html
<!-- _includes/head-common.html -->

<!-- css和js文件由内部的npm工程输出 -->
<!-- 这里用Jekyll的Liquid模版语言隐藏掉这段指向本地资源的代码 -->
{% comment %}
<!-- only for test -->
<link rel="stylesheet" href="/npm/dist/apqx.v[version].css" />
<script type="text/javascript" src="/npm/dist/apqx.v[version].js"></script>
<link rel="stylesheet" href="/css/materialFontsIcons.css" />
{% endcomment %}

<!-- for publish -->
<link rel="stylesheet" href="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/apqx.v[version].css" />
<script type="text/javascript" src="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/apqx.v[version].js"></script>
<link rel="stylesheet" href="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/materialFontsIcons.css" />
<!-- Global site tag (gtag.js) - Google Analytics -->
<!-- close it when on test -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-GDLCDFZXBF"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag() { dataLayer.push(arguments); }
gtag('js', new Date());
gtag('config', 'G-GDLCDFZXBF');
</script>
<!-- 设置debug为false,将使用云端托管资源 -->
{% assign debug = false %}
```

把本地修改`commit``push`到自己的`GitHub repository``GitHub Pages`会自动执行`Jekyll`的编译操作,就像本地调试时那样把`Markdown`文章转换为`HTML`页面并更新到指定的域名下
本地修改`commit``push`到自己的`GitHub repository``GitHub Pages`会自动执行`Jekyll``build`操作,就像本地调试那样把`Markdown`文章转换为`HTML`页面并`serve`到指定域名下

```sh
# 本地commit
git commit
# push到自己的Github repository上
# push到自己的Github repository
git push origin
```

等待数秒或数分钟,取决于`Pages`等待执行的任务量,完成后`Pages`上的网页就会更新。
静候数秒或数分钟,取决于`Pages`等待执行的任务量,完成后`Pages`上的网页就会更新。
1 change: 1 addition & 0 deletions _includes/head-common.html
Original file line number Diff line number Diff line change
@@ -1,4 +1,5 @@
{% assign debug = false %}
{% assign version = "2.0.0" %}
<title>{{ page.title }}</title>
<meta charset="UTF-8" />
<meta name="debug" content="{{ debug }}" />
Expand Down
4 changes: 2 additions & 2 deletions _includes/head-debug.html
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
<!-- Only for debug, host on local -->
<link rel="stylesheet" href="{{ "/npm/dist/apqx-v2.1.6.css" }}" />
<script type="text/javascript" src="{{ "/npm/dist/apqx-v2.1.6.js" }}"></script>
<link rel="stylesheet" href="/npm/dist/apqx-v{{ version }}.css" />
<script type="text/javascript" src="/npm/dist/apqx-v{{ version }}.js"></script>
4 changes: 2 additions & 2 deletions _includes/head-release.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<!-- For publish, host on aliyun -->
<link rel="stylesheet" href="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/apqx-v2.1.6.css" />
<script type="text/javascript" src="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/apqx-v2.1.6.js"></script>
<link rel="stylesheet" href="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/apqx-v{{ version }}.css" />
<script type="text/javascript" src="https://apqx-host.oss-cn-hangzhou.aliyuncs.com/blog/apqx-v{{ version }}.js"></script>
<!-- Global site tag (gtag.js) - Google Analytics -->
<!-- close it when on test -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-GDLCDFZXBF"></script>
Expand Down
10 changes: 5 additions & 5 deletions _posts/original/2019-05-18-槐安国内春生酒.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,21 +20,21 @@ tags: 碎碎念 记忆 戏剧 昆曲 省昆 南柯梦 牡丹亭 单雯 施夏明
<source src="https://apqx.oss-cn-hangzhou.aliyuncs.com/blog/20190518/kunqv_nankemeng_h264.mp4" type="video/mp4">
</video>

“槐安国内春生酒”,很多次了,我都会在心中反反复复,其实我对文字十分敏感,尤其诗词谱曲,总能品出些不一样的感觉,这些`“意味”`很微妙,在脑海中稍纵即逝,但每次出现,总是`“意”`犹不尽,让我不断想起我的童年,我的现在,现实与理想的碰撞,而最终,我又为什么会喜欢戏剧。我觉得也许是时候付诸笔墨,把我心中所想,尽可能准确的用文字表达出来。
“槐安国内春生酒”,很多次了,我都会在心中反反复复,其实我对文字十分敏感,尤其诗词谱曲,总能品出些不一样的感觉,这些`“意味”`很微妙,在脑海中稍纵即逝,但每次出现总是`“意”`犹不尽,让我不断想起我的童年,我的现在,现实与理想的碰撞,而最终,我又为什么会喜欢戏剧。我觉得也许是时候付诸笔墨,把我心中所想,尽可能准确的用文字表达出来。

# 豫东

我出生于豫东的一个小角落,在安徽和山东的南北夹缝中,一个名为`商丘`的地方,意为“商代的土堆”,其实是殷商的故都,这个名字在我15岁去市里读高中之前,都是十分陌生的。它下属的`虞城县`-`利民镇`-`三里井`,才是我的故乡,这个小小的县城又自称“木兰之乡”,也是我在15岁的时候才知道的。我的童年伴随着内敛、单纯和循规守矩,但偏偏又表现出过多的创造性,喜欢一个人摆弄火药和金属零件,用一堆乱七八糟的东西拼凑我想要的“硬核”战车,不断的改型和尝试总会让我乐在其中。这些“蒸汽朋克”之外,还有`凤凰中文台`的历史、文明、政治、战争纪录片和一本本军事、科技杂志,它们共同填充了我六年中学的课外时光。
我出生于豫东的一个小角落,在安徽和山东的南北夹缝中,一个名为`商丘`的地方,意为“商代的土堆”,其实是殷商的故都,这个名字在我15岁去市里读高中之前,都是十分陌生的。它下属的`虞城县`-`利民镇`-`三里井`,才是我的故乡,这个小小的县城又自称“木兰之乡”,也是我在15岁的时候才知道的。我的童年伴随着内敛、单纯和循规守矩,但偏偏又表现出过多的创造性,喜欢一个人摆弄火药和金属零件,用一堆东拼西凑的东西组合我想要的“硬核”战车,不断的改型和尝试总会让我乐在其中。这些“蒸汽朋克”之外,还有`凤凰中文台`的历史、文明、政治、战争纪录片和一本本军事、科技杂志,它们共同填充了我六年中学的课外时光。

很早就接触过如此庞大的多元信息,是否说明我的眼界十分开阔呢?可惜并不是,“多元”只是相对于枯燥的学业,“开阔”也仅限我喜欢的特定领域,乡镇少年普遍缺乏对真实世界的认知,正是信息壁垒,让很多人依旧持有在现代看来十分“不现代”的观念。这样的氛围下,我身边也发生着一些可悲的事情,让我记忆深刻的的义务教育阶段,堂堂一个镇的中学里,七年级时9个班,八年级时6个班,到九年级时仅能剩下4个班,真正读了高中的2个班,考入正经大学的便更加屈指可数了。这些荒诞的现象,在我成长起来的家乡,至少8年前,是真实存在的。

每个人“生而不同,独一无二”,我是认同的,很多时候我并不想接触不感兴趣的人和事,但一定会用`诚意`来获得尊重,就是这样的由疏渐近又不过分亲昵,让我能与同学、同事、朋友维持着很好的关系。回想起来,即使在我小时候,也不喜欢综艺和流行的“挂QQ”“非主流”之类,有点过于理性,不盲从,跟随内心而忽略外界视线。自陷于感性世界带给我决策的果断与独立,可能大部分时间看起来都很“平静”,其实是内心活动不流于表面。诚实说,看人家三五成群,一些瞬间也会有一点点的失落,不过我有自己的朋友,是我在选择,哪个圈子更适合我。换言之,**“君子之交淡如水”,真正的友谊是建立在尊重、欣赏、共鸣之上的,如此交心,宁缺毋滥。**
每个人“生而不同,独一无二”,我是认同的,很多时候我并不想接触不感兴趣的人和事,但一定会用`诚意`来获得尊重,就是这样的由疏渐近又不过分亲昵,让我能与同学、同事、朋友维持着很好的关系。回想起来,即使在我小时候,也不喜欢流行的综艺和“挂QQ”“非主流”之类,有点过于理性,不盲从,跟随内心而忽略外界视线。自陷于感性世界带给我决策的果断与独立,可能大部分时间看起来都很“平静”,其实是内心活动不流于表面。诚实说,看人家三五成群,一些瞬间也会有一点点的失落,不过我有自己的朋友,是我在选择,哪个圈子更适合我。换言之,**“君子之交淡如水”,真正的友谊是建立在尊重、欣赏、共鸣之上,如此交心,宁缺毋滥。**

小时候,我经历过两次所谓“感恩教育”,让我开始觉得这个世界的一些事情“不太正常”。第一次是在八年级,我们被集中在大礼堂观看邹越的演讲视频,他提到了父母的付出、老师的培育和其它一些十分具有感染力的话题,我认为他讲的很不错,但也仅此而已,除了对极具煽情的语气有些不适应外并没有别的特殊感觉。然而当我环顾四周却发现真的哭成了一片,当时的我很难理解他们为什么会表现的如此情绪化,后来我知道,是青春期天然具有的个性萌芽被人以`蓄意的心理攻势`直接击溃。只是对我无效,因为我那会儿是非常“循规守矩”的“乖孩子”和“好学生”,他那一套基于羞愧和道德的指责自然不起作用。不过某种程度上,没能在花样年华形成多彩个性反倒是另一种悲哀,我之后留下的很多遗憾都与此相关。
小时候,我经历过两次所谓“感恩教育”,让我开始觉得这个世界的一些事情“不正常”。第一次是在八年级,我们被集中在大礼堂观看邹越的演讲视频,他提到了父母的付出、老师的培育和其它一些十分具有感染力的话题,我认为他讲的很不错,但也仅此而已,除了对极具煽情的语气有些不适应外并没有别的特殊感觉。然而当我环顾四周却发现真的哭成了一片,当时的我很难理解他们为什么会表现的如此情绪化,后来我知道,是青春期天然具有的个性萌芽被人以`蓄意的心理攻势`迎面击溃。只是对我无效,因为我那会儿是非常“循规守矩”的“乖孩子”和“好学生”,他那一套基于羞愧和道德的指责自然不起作用。不过某种程度上,没能在花样年华形成多彩个性反倒是另一种悲哀,我之后留下的很多遗憾都与此相关。

邹和他们就是用这种方式在二三线城市周边的中小学巡演卖书,但是除了看起来震撼的齐哭场面外并没有实际作用,现场哭的最“痛苦”的“坏孩子”之后依然是“坏孩子”,与当时“感动”的样子对比就是最大的滑稽,我没看到过有实质的改变。**人之观念是在生长环境的潜移默化中形成的,需要改变的是身当作则的成年人,而不是一味让小孩子“感动”。**

我不喜欢滥用“感恩”,其“政治正确”难以批评,但它总是把很多功利行为描述为无私奉献,然后让处在叛逆期的人去“感动”。可能有人看到这些场面得到了心理的极大满足,但我觉得更多的结果还是适得其反,一旦小孩子长大,回过神来,发现曾经被人像耍猴一样愚弄,会激起更大的反感。
我不喜欢滥用“感恩”,其“政治正确”难以批评,但它总是把很多功利行为描述为无私奉献,然后让处在叛逆期的人去“感动”。可能有人看到这些场面得到了心理的极大满足,但我觉得更多的结果还是适得其反,一旦小孩子长大,回过神来,发现曾被人像耍猴一样愚弄,会激起更大的反感。

# 碰撞

Expand Down
4 changes: 3 additions & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,6 +100,8 @@ redirect_from:
* 如果有看剧,[剧种][剧团][剧名][折子(全场戏除外)][演员][剧院]
* CS(二进制,Android,Gradle,Java,Jvm,Flutter,Git,GitHub,Jekyll,JavaScript,Google,GCE,VPS,ShadowSocks,HTTPS, SSH,RaspberryPi,Ubuntu,抓包,下载)

以上分类中的子项并不全,可以按需求新增。

### 转载文章tag

戏剧,昆曲,京剧,历史,[作者][人物],思维,看客(贬义)
Expand All @@ -126,7 +128,7 @@ redirect_from:

## redirect_from

为当前文章页面生成一个指定的URL,使这个URL在<header>中重定向到当前文章。
为当前文章页面生成一个指定的URL,使这个URL在`<header>`中重定向到当前文章。

```html
<!DOCTYPE html>
Expand Down
Loading

0 comments on commit 8201839

Please sign in to comment.