https://github.com/assemble/assemble-docs/blob/master/src/templates/pages/docs/YAML.md.hbs
contains:
https://assemble/assemble/test/actual/yaml

Not sure where is should point to; there is no folder named assemble/test/actual/yaml anymore. Closest is: https://github.com/assemble/assemble/tree/master/test/fixtures/data but also contains .json files.

Thanks so much for assemble!

per helpers/handlebars-helpers#64 (comment)

We need better examples for sorting using:

• collections
• pages
• helpers

http://assemble.io/docs/Embedding-Code.html

on http://assemble.io/docs/YAML-front-matter.html#built-in-variables, it says:

"For each category and tag, Assemble will generate a page in the dest directory."

I cannot make this work. Any ideas?

I think perhaps there was a recent change. Before I was using {{md "README.md"}} to include a markdown file (as specified in the documents) but now this escapes all the html. I have to use {{{md "README.md"}}}.

On http://assemble.io/docs/Installation.html the text, the required local dependencies brings up a 404

https://github.com/assemble/assemble-docs/tree/master/src/readme

http://assemble.io/helpers/helpers-special.html which is linked to from http://assemble.io/helpers/helpers-strings.html

See 4bbe06f#commitcomment-3625813

A page/section covering how to generate output for Pretty URLs would be really helpful. It would be enough to start if the Assemble docs themselves provided the example by using pretty URLs.

On step 1 on this page http://assemble.io/docs/Quickstart.html, this command:

git clone [email protected]:assemble/assemble.git "my-project"

gives:

Cloning into 'my-project'...
Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

This is on 64bit Windows 8, if that helps.

per assemble/assemble#356

http://assemble.io/docs/options-collections.html

This paragraph accidentally a word. ;P

Although a "page" is a collection item, there is currently no concept of "pages with related pages". In other words there is no object which contains a collection of pages associated with a given page. So

This paragraph has a misspelled word creatd:

There are no restrictions on the number of collections creatd, you may specify as many custom collections as you require.

https://github.com/helpers/helper-jade

#50

https://github.com/assemble/assemble/pull/327/files

See c927302#commitcomment-3625865

No comparison helper on http://assemble.io/docs/helpers/index.html

Same when running grunt. Comparison helper not generated.

Here http://assemble.io/helpers/helpers-dates.html link to formatDate & his author are not good (it seems he changes is nickname).

https://github.com/brightbits/formatDate-js seems the good link now.

Im having an issue as described vkocubinsky/SublimeTableEditor#42, I wonder if this is some limitation from the parser in Assemble.

https://github.com/helpers/helper-prettify

http://assemble.io/docs/Context.html

"this" expression -section code example is not too helpful:

<ul class="people-list">

</ul>

Should be something like:

<ul class="people-list">
  {{#each people}}
  <li>{{this}}</li>
  {{/each}}
</ul>

On this page the link to 'YAML test files' is broken.

• clear out the src/readme dir: https://github.com/assemble/assemble-docs/tree/master/src/readme
• data and partials, most of them aren't even being used. they need to be thrown out
• https://github.com/assemble/assemble-docs/tree/master/src/content the readme and toc need to go

http://assemble.io/docs/Data.html

myTemplate.hbs -file has wrong content or is missing its contents, should probably be something like:

{{title}}

and for the second example with missing contents:

{{myData.title}}

Apologies if I've misunderstood something, still struggling with the pages collection. If I add this to my templates:

{{#each pages}}
{{pagename}}
{{/each}}

On pages apart from index.html it outputs the names of pages apart from index.html. On index.html it only lists index.html. Is this by design, or has something gone awry? I thought perhaps it was due to the pages section of my assemble config, but I have modifed this as shown and it still happens:

assemble: {
    options: {
        flatten: true,
        layout: '<%= yeoman.src %>/templates/layouts/default.hbs',
        partials: '<%= yeoman.src %>/templates/partials/*.hbs',
        data: 'site.json'
    },
    pages: {
        options: {
            flatten: true,
            layout: 'src/templates/layouts/default.hbs'
        },
        files: [
            {expand: true, cwd: 'src/templates/pages', src: ['*.hbs'], dest: 'dist/'}
        ]
    }
}

per this issue assemble/assemble#305

and this is because I didn't add a section to the YFM of that page! doh

• use nested layouts
• make section styles dynamic, probably using a helper, so that it's not necessary to use a different layout for each section just to change the sidenav and subhead color

We need to get some color (just a little) on the landing page. Ideally we will have some kind of section below the masthead for illustrating the "assemble ecosystem". The illustration should be simple, lots of whitespace, and demonstrate where assemble fits into the picture with grunt, yeoman and components

Well, to be frank, the whole logo branding seems to be missing. Any ideas? If you would have some pointers on branding, I could possibly whip up something to fill the void. :)

Or do you have something already planned for the logo?

The docs show this for iterating a page's categories and tags:

<ul>
    {{#page.categories}}
    <li>{{.}}</li>
    {{/page.categories}}
</ul>

<ul>
    {{#page.tags}}
    <li>{{.}}</li>
    {{/page.tags}}
</ul>

I couldn't get either of those to work though, what worked for me was this:

{{#with page}}
<ul>
    {{#each data.tags}}
    <li>{{.}}</li>
    {{/each}}
</ul>
{{/with}}

This also works for categories, if the 'each' is modified. I don't know if this is right, or the only way of doing it, though?

Sorry about all this...

On the Pages bit of the docs, under Using YFM with the page variable, it has this:

<ul>
    {{#each pages}}
    <li><a href="#">{{../page.title}}</a></li>
    {{/each}}
</ul>

suggesting this will output the title (from each page's YFM) - if I paste that code into the top of example.hbs from the examples project it just outputs this (and I see the same thing in my own project):

<ul>
    <li><a href="#">Examples</a></li>
    <li><a href="#">Examples</a></li>
    <li><a href="#">Examples</a></li>
    <li><a href="#">Examples</a></li>
    <li><a href="#">Examples</a></li>
</ul>

https://github.com/helpers/helper-repeat

The final section here talks about sorting the pages collection:

<ul>
    {{#withSort pages data.date}}
        <li>{{data.title}}</li>
    {{/withSort}}
</ul>

If I add that code to a page within the boilerplate-bootstrap project, for example, the build fails with

Warning: Cannot read property 'hash' of undefined Use --force to continue
Aborted due to warnings.

This will build

    {{#withSort pages date}}

But the output is not sorted.

Am I missing something, should this work?

Add an i18n folder to this dir: https://github.com/assemble/assemble-docs/tree/master/src/content/helpers.

per issue assemble/assemble#85

The organizational structure here is out of date and needs to be synced up with the actual organizational structure of the helpers.

The See the template for this page → link on About.html points to About.hbs but should point to About.md.hbs. Not sure if it's just the one page or not.

In the section "Markdown options" the link to marked goes to http://assemble.io/docs/marked which is a broken link.

Also, it mentions in this section that these options from marked are "available for changing behavior". I can't seem to figure out how modify these properties. Can you explain this in the documentation?