Ghost手册（2018.12.20）

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

文件路径

MarkDown/快捷键

相关资源

• Ghost 中文文档
• Handlebars
• Node.js
• Ghost 资料/教程

Default.hbs

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

Head

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

Body

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

Footer

{{@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}}

Header

{{#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}}