Ghost手册(2018.12.20)

不再维护的中文Ghost开源站点:https://www.ghostchina.com/ghost-cheat-sheet/

文件路径

配置文件/config.js
主题/content/themes
插件/content/apps
图片/content/images
导航(默认)/core/server/helpers/tpl/navigation.hbs
分页(默认)core/server/helpers/tpl/pagination.hbs

MarkDown/快捷键

Save-Ctrl + S
Bold**text**Ctrl / Cmd + B
Emphasize__text__Ctrl / Cmd + I
Inline Code`code`Cmd + K / Ctrl + Shift + K
Link[title](http://)Ctrl + Shift + L
Image![alt](http://)Ctrl + Shift + I
List* itemCtrl + L
H1# HeadingCtrl + Alt + 1
H2## HeadingCtrl + Alt + 2
H3### HeadingCtrl + Alt + 3
Select WordCtrl + Alt + W
Uppercase-Ctrl + U
Lowercase-Ctrl + Shift + U
Titlecase-Ctrl + Alt + Shift + U
Insert Current Date-Ctrl + Shift + 1

相关资源


Default.hbs

default.hbs 文件中可以用到的 Handlebars 指令

{{meta_title}}
{{meta_description}}
{{ghost_head}}

Body

{{body_class}}
{{{body}}}

{{@blog.title}}
{{@blog.url}}/rss/
{{ghost_foot}}


主题构成

  • /assets
    • /css
      • screen.css
      • post.css
    • /fonts
    • /images
    • /js
    • /partials
      • pagination.hbs
  • default.hbs
  • index.hbs [必须]
  • post.hbs [必须]
  • page.hbs [可选]
  • tag.hbs [可选]
  • package.json

Handlebars

注释

{{! 'A Comment' }}

HTML 转义

{{content}}

if 指令

{{#if author.website}}
{{else}}
{{/if}}

unless 指令

{{#unless author.website}}
{{/unless}}

foreach 指令

{{#foreach posts}}
{{/foreach}}

块表达式

{{#author}}
{{/author}}


Index.hbs

index.hbs 文件中可以使用的 Handlebars 指令

加载父模板 default.hbs

{{!< default}}

{{#if @blog.cover}}
{{@blog.cover}}
{{/if}}

{{#if @blog.logo}}
{{@blog.logo}}
{{/if}}
{{@blog.title}}
{{@blog.description}}

文章

{{#foreach posts}}
{{/foreach}}
{{post_class}}
{{date format='YYYY-MM-DD'}}
{{date published_at format="MMMM DD, YYYY"}}
{{date published_at timeago="true"}}

{{#if tags}}
{{tags}}
{{tags separator=" | "}}
{{/if}}

{{excerpt}}
{{excerpt characters="140"}}
{{content}}
{{content words="100"}}

分页

{{pagination}}


API 概览

  1. @blog.title
  2. @blog.url
  3. @blog.logo
  4. @blog.description
  5. meta_title
  6. meta_description
  7. body
  8. body_class
  9. ghost_head
  10. ghost_foot
  11. pagination
    • next
    • page
    • pages
    • page_url prev
    • page_url next
    • prev
  12. post_class
  13. post, posts
  14. author
    • name
    • website
    • bio
    • cover
    • email
    • image
  15. excerpt [characters][words]
  16. content [characters][words]
  17. url [absolute]
  18. tags [separator]
    • name
  19. date [format][timeago]
  20. id
  21. published_at

Post.hbs

post.hbs 文件中可以使用的 Handlebars 指令

加载父模板 default.hbs

{{!< default}}

Header

{{#if @blog.cover}}
{{@blog.cover}}
{{/if}}

{{#if @blog.logo}}
{{@blog.logo}}
{{/if}}

{{@blog.title}}
{{@blog.description}}
{{date published_at timeago="true"}}

文章

{{post_class}}
{{#if}}
{{else}}
{{/if}}

{{#post}}
{{/post}}
{{url}}
{{{title}}}
{{date format='YYYY-MM-DD'}}
{{date published_at format="MMMM DD, YYYY"}}
{{#if tags}} {{tags}}
{{tags separator=" | "}}
{{/if}}
{{content}}

作者信息

{{#author}}
{{/author}}

{{#if author}}
{{/if}}

{{author.name}}
{{author.bio}}
{{author.email}
{{author.website}}
{{author.image}}
{{author.cover}}