zoukankan      html  css  js  c++  java

  • GHOST CMS

    Data Helpers

    Data helpers are used to output data from your site. Use this reference list to discover what each handlebars helper can do when building a custom Ghost theme.

    Available data helpers

    @config

    The @config property provides access to global data properties, which are available anywhere in your theme.

    Specifically @config will pass through the special theme config that is added in the theme's package.json so that it can be used anywhere in handlebars.

    At the moment, there is only one property which will be passed through:

    • {{@config.posts_per_page}} – the number of posts per page

    Example Code

    Standard usage:

    <a href="{{page_url "next"}}">Show next {{@config.posts_per_page}} posts</a>

    In the get helper limit field:

    {{#get "posts" filter="featured:true" limit=@config.posts_per_page}}
  {{#foreach posts}}
      <h1>{{title}}</h1>
	{{/foreach}}
{{/get}}

    Providing config

    Config values can be provided by adding a config block to package.json

    {
  "name": "my-theme",
  "version": 1.0.0,
  "author": {
    "email": "my@address.here"
  }
  "config": {
  }
}

    Inside of the config block, there is currently a single supported property - posts_per_page.

    {
  "name": "my-theme",
  "version": 1.0.0,
  "author": {
    "email": "my@address.here"
  }
  "config": {
    "posts_per_page": 10
  }
}


    

    

    @site
    

    

    The @site property provides access to global settings, which are available anywhere in your theme:
    

      

    • {{@site.url}} – the url specified for this site in your custom config file
      • 

    • {{@site.title}} – the site title from general settings
      • 

    • {{@site.description}} – the site description from general settings
      • 

    • {{@site.icon}} - The publication icon from general settings
      • 

    • {{@site.logo}} – the site logo from general settings
      • 

    • {{@site.cover_image}} – the site cover image from general settings
      • 

    • {{@site.twitter}} – the twitter URL from general settings
      • 

    • {{@site.facebook}} – the facebook URL from general settings
      • 

    • {{@site.navigation}} – the navigation information configured in settings/design
      • 

    • {{@site.timezone}} – the timezone as configured in general settings
      • 

    • {{@site.lang}} - the configured site language.
      • 

    

    Example Code
    

    default.hbs
    

    

    <html lang="{{@site.lang}}">

...

<nav class="main-nav overlay clearfix">
    {{#if @site.logo}}
        <a class="blog-logo" href="{{@site.url}}"><img src="{{@site.logo}}" alt="Blog Logo" /></a>
    {{/if}}
    <a class="subscribe-button icon-feed" href="{{@site.url}}/rss/">Subscribe</a>
 </nav>

 ...

</html>
    

    

    @site meta data
    

    The @site helper provides more extensive attributes around site meta data as well. The @site meta data values can be set in the Ghost admin under Site Meta Settings within General Settings:
    

      

    • {{@site.meta_title}} – the site meta title
      • 

    • {{@site.meta_description}} – the site meta description
      • 

    • {{@site.twitter_image}} – the site Twitter card image
      • 

    • {{@site.twitter_title}} – the site Twitter card title
      • 

    • {{@site.twitter_description}} – the site Twitter card description
      • 

    • {{@site.og_image}} – the site open graph image (used when shared on Facebook)
      • 

    • {{@site.og_title}} – the site open graph title (used when shared on Facebook)
      • 

    • {{@site.og_description}} – the site open graph description (used when shared on Facebook)
      • 

    

    Here's how these helpers correspond with the settings in the Ghost admin:
    

    Ghost admin site meta settings
    

    You may see @blog used in older themes, this is outdated. @site should always be used instead.
    

    

    

    navigation
    

    

    Usage: {{navigation}} and {{navigation type="secondary"}}
    

    Description
    

    {{navigation}} is a template-driven helper which outputs formatted HTML of menu items defined in the Ghost admin panel (Settings > Design > Navigation). By default, the navigation is marked up using a preset template.
    

    There are two types of navigation, primary and secondary, which you can access using {{navigation}} and {{navigation type="secondary"}}.
    

    {{navigation}}是一个模板驱动的帮助器，它输出Ghost 管理面板中定义的菜单项的格式化HTML(设置>设计>导航)。默认情况下，导航是使用预设模板标记的。
    

    有两种类型的导航，主导航和辅助导航，您可以使用{{navigation}}和{{navigation type="secondary"}}访问它们。
    

    Default template
    

    By default, the HTML output by including {{navigation}} in your theme, looks like the following:
    

    

    <ul class="nav">
    <li class="nav-home nav-current"><a href="/">Home</a></li>
    <li class="nav-about"><a href="/about">About</a></li>
    <li class="nav-contact"><a href="/contact">Contact</a></li>
    ...
</ul>
    

    

    Changing The Template
    

    If you want to modify the default markup of the navigation helper, this can be achieved by creating a new file at ./partials/navigation.hbs. If this file exists, Ghost will load it instead of the default template. Example:
    

    如果您想修改导航助手的默认标记，可以通过在./partials/navigation.hbs上创建一个新文件来实现。如果这个文件存在，Ghost将加载它而不是默认模板。例子:
    

    

    <div class="my-fancy-nav-wrapper">
    <ul class="nav">
        <!-- Loop through the navigation items -->
        {{#foreach navigation}}
        <li class="nav-{{slug}}{{#if current}} nav-current{{/if}}"><a href="{{url absolute="true"}}">{{label}}</a></li>
        {{/foreach}}
        <!-- End the loop -->
    </ul>
</div>
    

    

    The up-to-date default template in Ghost is always available here.
    

    Ghost 中最新的默认模板总是在这里可用。
    

    List of Attributes
    

    A navigation item has the following attributes which can be used inside your ./partials/navigation.hbs template file...
    

      

    • {{label}} - The text to display for the link
      • 

    • {{url}} - The URL to link to - see the url helper for more options
      • 

    • {{current}} - Boolean true / false - whether the URL matches the current page
      • 

    • {{slug}} - Slugified name of the page, eg about-us. Can be used as a class to target specific menu items with CSS or jQuery.
      • 

    

    These attributes can only be used inside the {{#foreach navigation}} loop inside ./partials/navigation.hbs. A navigation loop will not work in other partial templates or theme files.
    

    Examples
    

    The navigation helper doesn't output anything if there are no navigation items to output, so there's no need to wrap it in an {{#if}} statement to prevent an empty list. However, it's a common pattern to want to output a link to open the main menu, but only if there are items to show.
    

    The data used by the {{navigation}} helper is also stored as a global variable called @site.navigation. You can use this global variable in any theme file to check if navigation items have been added by a user in the Ghost admin panel.
    

    

    {{#if @site.navigation}}
    <a class="menu-button" href="#"><span class="word">Menu</span></a>
{{/if}}
    

    

    This is also possible with the secondary navigation:
    

    

    {{#if @site.secondary_navigation}}
    <a class="menu-button" href="#"><span class="word">Menu</span></a>
{{/if}}


    

    

    

    

    post
    

    

    Usage: {{#post}}{{/post}} or {{#foreach posts}}{{/foreach}}
    

    Description
    

    When on a single post template such as post.hbs or page.hbs, outputting the details of your posts can be done with a block expression.
    

    The block expression {{#post}}{{/post}} isn't strictly a 'helper'. You can do this with any object in a template to access the nested attributes e.g. you can also use {{#primary_author}}{{/primary_author}} inside of the post block to get to the primary author's name and other attributes.
    

    When inside a post list such as index.hbs or tag.hbs where there is more than one post, it is common to use the {{#foreach post}}{{/foreach}} to iterate through the list.
    

    When inside a {{#foreach posts}}{{/foreach}} or {{#post}}{{/post}} block (i.e. when inside the post scope), theme authors have access to all of the properties and helpers detailed on this page.
    

    Post Attributes
    

    The full list of post attributes and more information about outputting posts can be found in the post context documentation.
    

    Static pages
    

    When outputting a static page, you can use the same {{#post}}{{/post}} block expression, and all the same helpers you can use for a post.
    


    Featured posts get an extra class so that they can be styled differently. They are not moved to the top of the post list or displayed separately to the normal post list.
    

    Use {{#if featured}}{{/if}} to test if the current post is featured.
    


    


    

    url
    

    

    Usage: {{url}}
    

    Description
    

    {{url}} outputs the relative url for a post when inside the post scope.
    

    You can force the url helper to output an absolute url by using the absolute option, E.g. {{url absolute="true"}}
    


    



    

    title
    

    

    Usage: {{title}}
    

    Description
    

    The title helper outputs a post title ensuring it displays correctly.
    


    


    

    img_url
    

    

    Usage: {{img_url value}}
    

    Description
    

    The img url helper outputs the correctly calculated URL for the provided image property.
    

    You must tell the {{img_url}} helper which image you would like to output. E.g. if you want to output a url for a post's feature image inside of post.hbs you might use {{img_url feature_image}}.
    

    You can force the image helper to output an absolute url by using the absolute option, E.g. {{img_url profile_image absolute="true"}}. This is almost never needed.
    

    You can pass in dynamic image sizes, if you would like to output the image in question at a resized resolution based on your theme config.
    

    Example code
    

    Below is a set of examples of how you might output various images that belong to posts, authors or keywords:
    

    

    {{#post}}

  {{!-- Outputs post's feature image if there is one --}}
  {{#if feature_image}}
	<img src="{{img_url feature_image}}">
  {{/if}}

  {{!-- Output feature image at small size from theme package.json --}}
  <img src="{{img_url feature_image size="small"}}">

  {{!-- Output post author's profile image as an absolute URL --}}
  <img src="{{img_url author.profile_image absolute="true"}}">

  {{!-- Open author context instead of providing full path --}}
  {{#author}}
 	   <img src="{{img_url profile_image}}">
  {{/author}}

{{/post}}


    

    



    

    

    excerpt
    

    

    Usage: {{excerpt}}
    

    Description
    

    {{excerpt}} outputs content but strips all HTML. This is useful for creating excerpts of posts.
    

    {{excerpt}}输出内容，但删除所有HTML。这对于创建文章摘要非常有用。
    

    If the post's custom_excerpt property is set, then the helper will always output the custom_excerpt content ignoring the words & characters attributes.
    

    如果设置了post的custom_excerpt属性，那么帮助器将始终输出custom_excerpt 内容，忽略words & characters属性。
    

    When both html and custom_excerpt properties are not set (for example, when member content gating strips the html) the output is generated from post's excerptproperty.
    

    当没有设置html和custom_excerpt属性时(例如，当成员内容门控剥离html时)，输出将从post的摘录属性生成。
    

    You can limit the amount of text to output by passing one of the options:
    

    {{excerpt characters="140"}} will output 140 characters of text (rounding to the end of the current word).
    


    


    

    meta data
    

    

    Usage: {{meta_title}} and {{meta_description}} and {{canonical_url}}
    

    Description
    

    Ghost generates automatic meta data by default, but it can be overridden with custom content in the post settings menu. Meta data is output by default in ghost_head, and can also be used in themes with the following helpers:
    

      

    • {{meta_title}} – the meta title specified for the post or page in the post settings
      • 

    • {{meta_description}} – the meta description specified for the post or page in the post settings
      • 

    • {{canonical_url}} – the custom canonical URL set for the post
      • 

    

    


    

    content
    

    

    Usage: {{content}}
    

    Description
    

    {{content}} is a very simple helper used for outputting post content. It makes sure that your HTML gets output correctly.
    

    You can limit the amount of HTML content to output by passing one of the options:
    

    {{content words="100"}} will output just 100 words of HTML with correctly matched tags.
    


    



    

    date
    

    

    Usage: {{date value format="formatString"}}
    

    Description
    

    {{date}} is a formatting helper for outputting dates in various format. You can either pass it a date and a format string to be used to output the date like so:
    

    

    // outputs something like 'July 11, 2016'
{{date published_at format="MMMM DD, YYYY"}}
    

    

    Or you can pass it a date and the timeago flag:
    

    

    // outputs something like '5 mins ago'
{{date published_at timeago="true"}}
    

    

    If you call {{date}} without a format, it will default to “MMM Do, YYYY”.
    

    If you call {{date}} without telling it which date to display, it will default to one of two things:
    

      

    1. If there is a published_at property available (i.e. you're inside a post object) it will use that
      2. 

    2. Otherwise, it will default to the current date
      3. 

    

    date uses moment.js for formatting dates. See their documentation for a full explanation of all the different format strings that can be used.
    

    Example Code
    

    

    <main role="main">
  {{#foreach posts}}
    <h2><a href="{{url}}">{{title}}</a></h2>

   <p>{{excerpt words="26"}}</p>

    {{!-- Here `published_at` is set, so this will show the article date --}}
    <time datetime="{{date format="YYYY-MM-DD"}}">{{date format="DD MMMM YYYY"}}</time>
  {{/foreach}}
</main>
<footer>
  {{!-- Here there is no `published_at` so this will show the current year --}}
  <p class="small">&copy; {{date format="YYYY"}}</p>
</footer>

    

     
    

    



    

    tags
    

    

    Usage: {{tags}} or {{#foreach tags}}{{/foreach}} in tag.hbs you can use {{#tag}}{{/tag}} to access tag properties
    

    Description
    

    {{tags}} is a formatting helper for outputting a linked list of tags for a particular post. It defaults to a comma-separated list (without list markup) but can be customised to use different separators, and the linking can be disabled. The tags are output in the order they appear on the post, these can be reordered by dragging and dropping.
    

    The {{tags}} helper does not output internal tags. This can be changed by passing a different value to the visibility attribute.
    

    You can use the translation helper for the prefix and suffix attribute.
    

    Example code
    

    The basic use of the tags helper will output something like 'my-tag, my-other-tag, more-tagging' where each tag is linked to its own tag page:
    

    

    {{tags}}
    

    

    You can customise the separator between tags. The following will output something like 'my-tag | my-other-tag | more tagging'
    

    

    {{tags separator=" | "}}
    

    

    Additionally you can add an optional prefix or suffix. This example will output something like 'Tagged in: my-tag | my-other-tag | more tagging'
    

    

    {{tags separator=" | " prefix="Tagged in:"}}
    

    

    You can use HTML in the separator, prefix and suffix arguments. So you can achieve something like 'my-tag • my-other-tag • more tagging'.
    

    

    {{tags separator=" &bull; "}}
    

    

    If you don't want your list of tags to be automatically linked to their tag pages, you can turn this off:
    

    

    {{tags autolink="false"}}
    

    

    If you want to output a fixed number of tags, you can add a limit to the helper. E.g. adding a limit of 1 will output just the first tag:
    

    

    {{tags limit="1"}}
    

    

    If you want to output a specific range of tags, you can use from and to either together or on their own. Using to will override the limit attribute.
    

    E.g. using from="2" would output all tags, but starting from the second tag:
    

    

    {{tags from="2"}}
    

    

    E.g. setting both from and to to 1 would do the same as limit="1"
    

    {{tags from="1" to="1"}} is the same as {{tags limit="1"}}
    

    The visibility attribute
    

    As of Ghost 0.9 posts, tags and users all have a concept of visibility, which defaults to public. The key feature build on this so far is Internal Tags, which are tags where the visibility is marked as internal instead of public. These tags will therefore not be output by the {{tags}} helper unless you specifically ask for them.
    

    By default the visibility attribute is set to the string "public". This can be overridden to pass any other value, and if there is no matching value for visibility nothing will be output. E.g. you can set visibility to be "internal" to only output internal tags. You can also pass a comma-separated list of values, or the value "all" to output all items.
    

    

    {{tags visibility="all"}}
    

    

    Advanced example
    

    If you want to output your tags completely differently, you can fully customise the output by using the foreach helper, instead of the tags helper. Here's an example of how to output list markup:
    

    

    {{#post}}
  {{#if tags}}
    <ul>
    {{#foreach tags}}
      <li>
        <a href="{{url}}" title="{{name}}" class="tag tag-{{id}} {{slug}}">{{name}}</a>
      </li>
    {{/foreach}}
    </ul>
  {{/if}}
{{/post}}
    

    

    List of Attributes
    

      

    • id - the incremental ID of the tag
      • 

    • name - the name of the tag
      • 

    • slug - slugified version of the name (used in urls and also useful for class names)
      • 

    • description - a description of the tag
      • 

    • feature_image - the cover image for the tag
      • 

    • meta_title - the tag's meta title
      • 

    • meta_description - the tag's meta description
      • 

    • url - the web address for the tag's page
      • 

    

    primary_tag
    

    To output just the singular, first tag, use the {{primary_tag.name}}. You can also access all the same attributes in the object as above if you need more custom output.
    

    

    {{#primary_tag}}
<div class="primary-tag">
    <a href="{{url}}">{{name}}</a>
    <span class="description">{{description}}</span>
<div>
{{/primary_tag}}


    

    

    

    

    authors
    

    

    Usage: {{authors}}
    

    Description
    

    {{authors}} is a formatting helper for outputting a linked list of authors for a particular post. It defaults to a comma-separated list (without list markup) but can be customised to use different separators, and the linking can be disabled. The authors are output in the order they appear on the post, these can be reordered by dragging and dropping.
    

    You can use the translation helper for the prefix and suffix attribute.
    

    Example code
    

    The basic use of the authors helper will output something like 'sam, carl, tobias' where each author is linked to its own author page:
    

    

    {{authors}}
    

    

    You can customise the separator between authors. The following will output something like 'sam | carl | tobias'
    

    

    {{authors separator=" | "}}
    

    

    Additionally you can add an optional prefix or suffix. This example will output something like 'More about: sam, carl, tobias'.
    

    

    {{authors separator=" | " prefix="More about:"}}
    

    

    You can use HTML in the separator, prefix and suffix arguments. So you can achieve something like 'sam • carl • tobias'.
    

    

    {{authors separator=" &bull; "}}
    

    

    If you don't want your list of authors to be automatically linked to their author pages, you can turn this off:
    

    

    {{authors autolink="false"}}
    

    

    If you want to output a fixed number of authors, you can add a limit to the helper. E.g. adding a limit of 1 will output just the first author:
    

    

    {{authors limit="1"}}
    

    

    If you want to output a specific range of authors, you can use from and to either together or on their own. Using to will override the limit attribute.
    

    E.g. using from="2" would output all authors, but starting from the second author:
    

    

    {{authors from="2"}}
    

    

    E.g. setting both from and to to 1 would do the same as limit="1"
    

    {{authors from="1" to="1"}} is the same as {{authors limit="1"}}
    

    The visibility attribute
    

    As of Ghost 0.9 posts, tags and users all have a concept of visibility, which defaults to public.
    

    By default the visibility attribute is set to the string "public". This can be overridden to pass any other value, and if there is no matching value for visibility nothing will be output. You can also pass a comma-separated list of values, or the value "all" to output all items.
    

    

    {{authors visibility="all"}}
    

    

    Advanced example
    

    If you want to output your authors completely differently, you can fully customise the output by using the foreach helper, instead of the authors helper. Here's an example of how to output list markup:
    

    

    {{#post}}
  {{#if authors}}
    <ul>
    {{#foreach authors}}
      <li>
        <a href="{{url}}" title="{{name}}" class="author author-{{id}} {{slug}}">{{name}}</a>
      </li>
    {{/foreach}}
    </ul>
  {{/if}}
{{/post}}
    

    

    List of author attributes
    

      

    • id - the incremental ID of the author
      • 

    • name - the name of the author
      • 

    • slug - slugified version of the name (used in urls and also useful for class names)
      • 

    • bio - a bio of the author
      • 

    • website - the website of the author
      • 

    • location - the location of the author
      • 

    • twitter - the author's twitter username
      • 

    • facebook - the author's facebook username
      • 

    • profile_image - the profile image for the author
      • 

    • cover_image - the cover image for the author
      • 

    • meta_title - the tag's meta title
      • 

    • meta_description - the tag's meta description
      • 

    • url - the web address for the tag's page
      • 

    

    primary_author
    

    To output just the singular, first author, use the {{primary_author}} helper to output a simple link. You can also access all the same attributes as above if you need more custom output.
    

    

    {{#primary_author}}
<div class="author">
    <a href="{{url}}">{{name}}</a>
    <span class="bio">{{bio}}</span>
</div>
{{/primary_author}}


    

    

    

    twitter
    

    

    Usage: {{twitter_url}} or {{twitter_url @blog.twitter}} or {{twitter_url "myfavouritepage"}}
    

    Description
    

    This helper exists to make it easy to output a URL for a twitter page. Ghost has access to twitter page names/usernames for both users and for the site itself. When used without passing a username, the helper will look for a twitter username in the current template context, and then fallback to using @blog.twitter.
    

    If there is no twitter username set, the helper will output nothing at all.
    

    If you pass a variable or string to the helper, it will concatenate the value with the full url for a twitter page.
    

    Examples
    

    Output the author's twitter, using an author block:
    

    

    {{#foreach posts}}
  {{#author}}
    {{#if twitter}}<a href="{{twitter_url}}">Follow me on twitter</a>{{/if}}
  {{/author}}
{{/foreach}}


    

    



    

    

    facebook
    

    

    Usage: {{facebook_url}} or {{facebook_url @blog.facebook}} or {{facebook_url "myfavouritepage"}}
    

    Description
    

    This helper exists to make it easy to output a URL for a facebook page. Ghost has access two facebook page names/usernames for both users and for the site itself. When used without passing a username, the helper will look for a facebook username in the current template context, and then fallback to using @blog.facebook.
    

    If there is no facebook username set, the helper will output nothing at all.
    

    If you pass a variable or string to the helper, it will concatenate the value with the full url for a facebook page.
    

    Examples
    

    Output the author's facebook, using an author block:
    

    

    {{#foreach posts}}
  {{#author}}
    {{#if facebook}}<a href="{{facebook_url}}">Follow me on Facebook</a>{{/if}}
  {{/author}}
{{/foreach}}
    

    

    

    

    

    

    

    

    

    
     
                
    
                
              
    • 
              
    
              
  • 

                相关阅读:
    
                
                  使用postman模拟上传文件到springMVC的坑：the request was rejected because no multipart boundary was found
                    
    win10 安装多个版本的jdk，如何切换
                    
    String类的substring方法
                    
    tomcat7.0配置CORS(跨域资源共享)
                    
    win7下安装centos6.5后，开机无法进入选择双系统启动界面，只能启动centos的解决办法
                    
    java位运算
                    
    JDK源码--ArrayList浅析
                    
    使用Jasperreporter生成入库出库单打印等报表操作
                    
    centos6.5下安装zip格式的tomcat7和tomcat8，并同时运行
                    
    Centos7配置文件共享服务器SAMBA三步曲（转）
                    
                        
              
    • 
              
    
              
  • 
                原文地址：https://www.cnblogs.com/QDuck/p/12081499.html
              
    • 

            

          



          
          

            

            

          

        

      

      



      

      

        

          Copyright © 2011-2022 走看看