====== gosk is a static site generator written in Go.
- Markdown support
- Custom theme support
install golang first, if you don't have,see https://golang.org/doc/install (Notice:go version must >=1.2)
$ go get github.com/scottkiss/gosk
$ cd $GOPATH/github.com/scottkiss/gosk/bin
$ go build gosk.go
if build passing,do the next.
$ cd bin
#run the gosk(if in windows os,will be gosk.exe) file
$ ./gosk build(if in windows os : gosk build)
if there is no errors,Congratulations,a folder named public will be created in current folder,then you can host the publish folder use any web server which support serving static content.In gosk,it also provide a simple static web server for testing in local.
$ cd $GOPATH/github.com/scottkiss/gosk/bin
$ ./gosk run :80
It will run on https://localhost:8080/ if don't specify the port (Notic: Don't move the gosk(gosk.exe) file,keep it under the bin folder,and don't move the root folder too,Or it won't work)
Now,Open your web browser and visit: https://localhost/ - Enjoy it.
bin
| - publish #published folder,include compiled .html files
| - ... #assets
| - index.html
| - rss.xml
| - ... #more html files
| - root #root folder
| - assets #assets folder,include javascript and css files
| - pages #custom pages folder
| - posts #post folder
| - article1.md #metadata text file
| - article2.md #metadata text file
| - templates #template folder
| - default #default theme template
| - default-zh #default-zh theme template
| - ... #more themes template
| - config.yml #site global configure
| - nav.yml #navbar configure
| - pages.yml #custom site configure
| - gosk #gosk file
If you are using gosk too,please tell me by email.
- 支持Markdown
- 支持自定义主题
- 自带默认一个主题,支持代码高亮
- 编译文章速度快
- 更多特点,谁用谁知道^_^
$ go get github.com/scottkiss/gosk
$ cd $GOPATH/github.com/scottkiss/gosk/bin
$ go build gosk.go
编译通过后,进行下一步
$ cd bin
#运行编译生成的gosk(如果在windows平台下,是gosk.exe) 文件
$ ./gosk build(在windows平台下运行gosk build)
如果没什么出错提示,那么恭喜你,在当前目录下会创建一个叫public目录,然后你可以用任何 支持静态服务的服务器部署public目录。为了方便测试,gosk也内置了一个简陋的静态web服务器。
$ cd $GOPATH/github.com/scottkiss/gosk/bin
$ ./gosk run :80
如果不指定后面的参数(执行 ./gosk run)默认是运行在 https://localhost:8080/ (注意:不要移动gosk(gosk.exe)的位置,也不要移动root目录的位置,不然就无法成功编译或运行了。)
现在,打开您的浏览器并访问: https://localhost/
bin
| - publish #执行编译后生成的目录,静态站点根目录
| - ... #资源,如javascript和css
| - index.html #生成的首页文件
| - rss.xml
| - ... #更多html文件
| - root #根目录,存放待编译的模板文件等
| - assets #资源目录,包括javascript 和 css 文件
| - pages #自定义页面目录
| - posts #发布的文章目录
| - article1.md #markdown编写的元文本文件
| - article2.md #markdown编写的元文本文件
| - templates #模板目录
| - default #默认主题模版
| - default-zh #默认中文主题模版
| - ... #更多模版主题
| - config.yml #站点全局配置文件
| - nav.yml #站点导航栏配置文件
| - pages.yml #自定义页面配置文件
| - gosk #gosk 执行文件
gosk内置一个default主题,更多主题请前往gosk-theme
如果你也使用gosk,如果不介意,通过邮件告诉我哦。
View the LICENSE file