<div dir="ltr"><div><div><div>Just a quick note:<br><br></div>I for got to mention that using git-lfs and cloning via ssh do not mix.<br></div>You have to clone via https.<br><br></div>Dominic<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Feb 11, 2016 at 6:12 PM, Dominic Kempf <span dir="ltr"><<a href="mailto:dominic.r.kempf@gmail.com" target="_blank">dominic.r.kempf@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>Dear fellow Duners,<br><br>tl;dr: The new homepage layout is written, but porting, revising and adding content<br>is only possible as a group effort. The new page can easily be built locally.<br><br>As talked about before, we are working on a replacement for the current Dune website.<br>The new homepage uses the static site generator HUGO (<a href="http://www.gohugo.io" target="_blank">www.gohugo.io</a>)<br>The project got delayed, but I was able to invest a few days this week. Some stuff already<br>works, for some, your help is needed. So here is a status update:<br><br>You can browse the homepage sources here:<br><a href="https://gitlab.dune-project.org/infrastructure/dune-website" target="_blank">https://gitlab.dune-project.org/infrastructure/dune-website</a><br><a href="https://gitlab.dune-project.org/infrastructure/dune-website-builder" target="_blank">https://gitlab.dune-project.org/infrastructure/dune-website-builder</a><br><br>You can also build the homepage locally quite easily (a reason to settle for hugo!).<br>You need to install:<br>* git-lfs from <a href="https://git-lfs.github.com/" target="_blank">https://git-lfs.github.com/</a><br>* hugo from <a href="https://github.com/spf13/hugo/releases" target="_blank">https://github.com/spf13/hugo/releases</a><br>Having installed these requirements, type in the toplevel directory of dune-website:<br>hugo server --watch<br>This will spin up a webserver, allowing you to browse the page. The page will<br>update itself as soon as you apply any changes to the sources.<br><br>The following subdirectories of a hugo project are relevant when adding content:<br>* the contents folder contains content in form of markdown files.<br>  Each markdown file has a so-called front matter (separated by +++), that <br>  contains metadata of the page. For most normal contents, it is sufficient<br>  to specify the Title there. The structure within the content subdir<br>  is translated into the directory structure of the built homepage.<br>  (./content/about/<a href="http://dune.md" target="_blank">dune.md</a> appears at <a href="http://www.dune-project.org/about/dune" target="_blank">www.dune-project.org/about/dune</a>)<br>* the static folder contains all sorts of static data. Git LFS is used<br>  to add binary data. You can simply commit big pdfs or tarballs, no problem.<br><br>That was my short introduction into Hugo, for more information head over at<br><a href="http://www.gohugo.io" target="_blank">www.gohugo.io</a> and read the docs. I liked working with it. <br><br>Now, for the Dune website. I have tried to reproduce the main features of the old page<br>and extend it in some ways. To implement a two-level menu, I decided to use the<br>style of the hugo docs at <a href="https://gohugo.io/overview/introduction/" target="_blank">https://gohugo.io/overview/introduction/</a><br><br>Extending our current feature set, I introduced some content archetypes. An archetype is a<br>piece of content with a prepopulated frontmatter and a different set of templates<br>to render sites. You can add a new archetype item with:<br>hugo new <archetypename>/<itemname>.md<br></div>(note that this only works from the toplevel directory)<br><br><div>The following contents are managed through so called archetypes (see archetypes subdir):<br>* News items (called "news")<br>* Releases (called "releases")<br>* Dune Modules (called "modules")<br><br>News items work exactly as before. The timestamp is automatically added to the front matter.<br><br>The process of publishing a Dune releases is (or will be, as we will test all that with 2.4.1)<br>kind of automated through the releases archetype. The download section is populated automatically,<br>the markdown content is just the release notes. The menu automatically chooses the latest 3 releases<br>to link directly (excluding outdated point releases).<br><br>I added an archetype "modules" to document dune modules. This has the following effects:<br>* Each dune module has its own content page, just as some chosen few had before (the discretization<br>  modules, dune-grid-glue, dune-mc, dune-functions etc.)<br>* A module summary is automatically shown in the corresponding module group (check the menu!)<br>* Crosslinking to all requirements etc.<br>I would like this to become some sort of a database of available dune modules. <br><br>Building the doxygen documentation is done from the project dune-website-builder.<br>The documentation building is triggered through tags in the frontmatter of either releases<br>or dune modules. I am still struggling with some ugly stuff there.<br><br>Many developers asked for an "online editing" system. This is available as the last menu item (if on a page).<br>It uses gitlabs online editing system. <br><br>So, now what remains to be done:<br>* Customizing CSS to give the thing the proper dunish look.<br>* Adding CSS classes for news item and module short summary.<br>* Resolve the clashes between the main and doxygen CSS<br>* Dig through content for broken links<br>* Add aliases to the front matter where backwards compatibility is desired<br></div><div>* Write meaningful texts about in content/groups<br></div><div>* Write module pages for all existing Dune modules<br>* Discard outdated content, I have not taken such measures yet.<br></div><div>* Decide what to do with the gallery: Should it be integrated with the modules<br></div><div>  archetype or be separate?<br></div><div><br>As I have already invested quite some time, I cannot do all of that myself.<br>I count on all of you to help me with content. If somebody is into CSS, I would consider<br></div><div>that a very big help, as my apprecation for design is quite low. Of course, lots of<br></div><div>the old styles could be ported, too.<br><br></div><div>Best,<br></div><div>Dominic<br></div></div>
</blockquote></div><br></div>