zendframework / zf-mkdoc-theme

MkDocs theme and gh-pages automation scripts for ZF documentation
MIT License
13 stars 13 forks source link

Sidebar broken #33

Closed michalbundyra closed 6 years ago

michalbundyra commented 7 years ago

https://docs.zendframework.com/zend-expressive-hal/factories/#zendexpressivehallinkgeneratorfactory

screen shot 2017-09-21 at 09 45 55

Any suggestions what we can do with it?

froschdesign commented 7 years ago

Any suggestions what we can do with it?

I work on an update for this and some other problems.

A quick solution is CSS's word-break with the value break-all.

michalbundyra commented 7 years ago

@froschdesign When will you push your update? I would like to make more improvements to the template 😄

froschdesign commented 7 years ago

I would like to make more improvements to the template

The same here!

michalbundyra commented 7 years ago

The same here!

Go ahead then 👍

froschdesign commented 7 years ago

@webimpress I'm finished with a new component homepage, which brings a table of contents and removes the index.html file. And I working on a new and simpler layout.

michalbundyra commented 7 years ago

@froschdesign

I'm finished with a new component homepage,

Is there anywhere your PR to see how it looks now?

froschdesign commented 7 years ago

I will prepare a PR in the next days and add some screenshots.

michalbundyra commented 7 years ago

Great! Thanks! So you think is no point updating the current component homepage? I can push my changes (slack, forum links...) to the zendframework.github.io repo shortly...

froschdesign commented 7 years ago

I can push my changes…

Go for it. No problem!

I created a new file:

{% if page.is_homepage %}
    {% include "homepage.html" %}
{% else %}
    {{ page.content }}
{% endif %}

(include in content.html)

The homepage.html includes the header with component name and description, the installation with Composer and the new table of contents – all automatically generated. The index.html with the "jumbotron" is no longer needed.

froschdesign commented 6 years ago

@webimpress No problem with the new layout:

zend-expressive-hal