Warning: could not generate index.html (using provided install instructions)

[cosmicdreams]

I a developer were to follow the instructions provided in the README.md they would recieve the following warning when generating a hologram-based style guide:

$ hologram
Custom markdown renderer Cortanamarkdownrenderer loaded.
Warning: Could not generate index.html, there was no content generated for the category README.
Build completed. (-:

This is because the setting:

# Mark which category should be the index page
# Alternatively, you may have an index.md in the documentation assets
# folder instead of specifying this config.
index: README

seems to declare a category that will drive the index rather than the name of file.

[cosmicdreams]

In addition getting errors when using an appropriate category for the index:

$ hologram
Custom markdown renderer Cortanamarkdownrenderer loaded.
Warning: Could not generate index.html, there was no content generated for the category general - t
ext.
Build completed. (-: 

[hupf]

I'm having the same issue here with Hologram 1.2.0 and Cortana 1.2.8:

$ hologram -c hologram_config.yml 
Custom markdown renderer Cortanamarkdownrenderer loaded.
Warning: Could not generate index.html, there was no content generated for the category README.
Build completed. (-: 

I have a README.md file containing markdown in this directory and the following in my hologram_config.yml:

# To have a custom index page build with your README.md
index: README

I see that the Cortana-example has been built quite some time ago. How can I build and test this example locally, where do I find the source with the corresponding config.yml?

[hkutcher]

+1 Having the same issue.

[Jaace]

I'm using Hologram 1.3.1 and Cortana 1.2.8. Creating the README.md in my source directory prevented this warning from popping up, so it seems like this is fixed now.

[chrisbarnes]

I don't think this is fixed. I'm having the same issues as mentioned above. If I set a valid category as the index page it generates the index.html file ok. It fails to work when i try to use a readme.md file.

[Jaace]

In my hologram_config.yml file

source: ./assets/css/sass
...
index: README

Then in my source directory I have ( /assets/css/sass/README.md ) which contains some markdown and it's generating the style guide for me. I don't know if maybe your source file isn't picking up from the right place? What versions are you using?

[ladislavsulc]

Hi, I have the same problem :( I use Cortana 1.2.8 and "grunt-hologram": "0.0.7", happened also with 0.0.6.

[femontanha]

@cosmicdreams create a index.md in your source folder and remove the index param in hologram.yml

my hologram ex:
source: ./assets/sass/

My path = assets/sass/index.md