Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aliqin/aliqin.github.io
f2e team of alibaba telecom
https://github.com/aliqin/aliqin.github.io
alibaba aliqin frontend hugo-blog
Last synced: 6 days ago
JSON representation
f2e team of alibaba telecom
- Host: GitHub
- URL: https://github.com/aliqin/aliqin.github.io
- Owner: aliqin
- License: mit
- Created: 2014-08-14T10:47:20.000Z (over 10 years ago)
- Default Branch: hugo-blog
- Last Pushed: 2017-03-21T02:32:36.000Z (over 7 years ago)
- Last Synced: 2024-03-21T07:31:32.761Z (8 months ago)
- Topics: alibaba, aliqin, frontend, hugo-blog
- Language: HTML
- Homepage: http://aliqin.github.io
- Size: 5.39 MB
- Stars: 6
- Watchers: 10
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# aliqin 官方技术博客
#### [http://aliqin.github.io](http://aliqin.github.io)
## 贡献博客
基于 [Hugo](https://gohugo.io/) 静态站点生成器，主题源于 [Casper](http://themes.gohugo.io/casper/).
```bash
# install Hugo: https://gohugo.io/overview/installing/
brew update && brew install hugo
# clone this repo
git clone [email protected]:aliqin/aliqin.github.io.git && cd aliqin.github.io
# clone casper themes, and remote the .git info
cd themes
git clone https://github.com/vjeantet/hugo-theme-casper casper
rm -fr casper/.git
# return root and server, then visit http://localhost:1313/
cd .. && hugo server
```
### 新建博客文章
```bash
# 统一使用date-article-name.md命名格式,如20170101-ES6-in-depth.md
hugo new post/your-article.md
```
此时会在content/post下面新建一篇文章，内容以及含义如下：
```
+++
# 必填，文章日期，自动生成
date = "2017-03-19T10:41:35+08:00"
# 必填，作者信息，会自动匹配data/authors下面作者信息，文件名即author名，如果你没找到自己请自行加上
author = "aliqin"
# 文章标签，可不填，控制在4个以内
tags = []
# 文章标题
title = "文章标题"
# 是否允许分享
share = true
# 是否允许评论
comments = true
# 是否有封面图片
image = ""
# 是否为草稿，如果为true则不会发布到网站
draft = false
+++
文章概要，这段文本将显示在文章列表里面。
这里是文章正文。
```
所有本地工作完成后，就可以发布了，以下命令会把public目录发布到master分支
```bash
npm run deploy
```
之后回到根目录执行`hugo`命令生成静态网站并提交：
```bash
cd .. && hugo && cd public
git add . && git commit -m 'add new post'
git push origin master
```
## 网站开发
网站开发分为两块，一块是css/js/img 静态文件，工作目录为src/文件夹，一块是html模板文件，工作目录为layouts/文件夹。
```bash
# 安装依赖
npm install
# 启动hugo 服务，实时预览页面, 并且实时监听静态css/js文件修改
npm run dev
```
Hugo的基本思路是默认使用themes/casper下面的文件，如果在项目根目录下有同名文件，则会有限使用根目录下文件。
比如可以用根目录下的`layouts/`文件夹中内容覆盖`themes/casper/layouts`中内容，`static/css/screen.css`覆盖`themes/casper/static/css/screen.css`中内容。
> 不要直接修改static/中文件，修改src/下文件然后`npm run build`生成在public/中。
完成开发后执行`npm run build`，之后将public文件夹push到master即可。