<div dir="ltr"><div><div><div><div>Hey Oliver,<br><br></div>putting it into beta production seems like a great idea. I will try to do that next week and inform you on this list!<br></div>I cannot explain why --watch did not work for you. I have not heard any reports about this before...<br><br></div>Best,<br></div>Dominic<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Wed, Mar 9, 2016 at 11:58 AM, Oliver Sander <span dir="ltr"><<a href="mailto:oliver.sander@tu-dresden.de" target="_blank">oliver.sander@tu-dresden.de</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Dominic,<br>
<br>
I had a quick look at the new documentation the other day, and there were many things<br>
I liked.  Thanks for all the work you guys put into this.<br>
<br>
A few comments:<br>
<br>
- hugo is in Debian testing, so getting that installed was trivial<br>
- however, an instance started with<br>
<br>
  hugo server --watch<br>
<br>
  did not rebuild the pages when I changed the source.  May have been my fault, though.<br>
<br>
- Is there already an actual public-but-hidden webserver that shows these pages?<br>
  I think it would motivate me more to work on the new pages if I knew that in principle<br>
  anybody can see them on the internet.  I'd suggest to even add a 'check out our new<br>
  beta website at ...' link to our current homepage.<br>
<br>
Best,<br>
Oliver<br>
<span class=""><br>
On 11.02.2016 18:12, Dominic Kempf wrote:<br>
> 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>
</span>> The new homepage uses the static site generator HUGO (<a href="http://www.gohugo.io" rel="noreferrer" target="_blank">www.gohugo.io</a> <<a href="http://www.gohugo.io" rel="noreferrer" target="_blank">http://www.gohugo.io</a>>)<br>
<span class="">> 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" rel="noreferrer" target="_blank">https://gitlab.dune-project.org/infrastructure/dune-website</a><br>
> <a href="https://gitlab.dune-project.org/infrastructure/dune-website-builder" rel="noreferrer" 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/" rel="noreferrer" target="_blank">https://git-lfs.github.com/</a><br>
> * hugo from <a href="https://github.com/spf13/hugo/releases" rel="noreferrer" 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>
</span>>   (./content/about/<a href="http://dune.md" rel="noreferrer" target="_blank">dune.md</a> <<a href="http://dune.md" rel="noreferrer" target="_blank">http://dune.md</a>> appears at <a href="http://www.dune-project.org/about/dune" rel="noreferrer" target="_blank">www.dune-project.org/about/dune</a> <<a href="http://www.dune-project.org/about/dune" rel="noreferrer" target="_blank">http://www.dune-project.org/about/dune</a>>)<br>
<span class="">> * 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>
</span>> <a href="http://www.gohugo.io" rel="noreferrer" target="_blank">www.gohugo.io</a> <<a href="http://www.gohugo.io" rel="noreferrer" target="_blank">http://www.gohugo.io</a>> and read the docs. I liked working with it.<br>
<div class="HOEnZb"><div class="h5">><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/" rel="noreferrer" 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>
> (note that this only works from the toplevel directory)<br>
><br>
> 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>
> * Write meaningful texts about in content/groups<br>
> * Write module pages for all existing Dune modules<br>
> * Discard outdated content, I have not taken such measures yet.<br>
> * Decide what to do with the gallery: Should it be integrated with the modules<br>
>   archetype or be separate?<br>
><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>
> that a very big help, as my apprecation for design is quite low. Of course, lots of<br>
> the old styles could be ported, too.<br>
><br>
> Best,<br>
> Dominic<br>
><br>
><br>
</div></div><div class="HOEnZb"><div class="h5">> _______________________________________________<br>
> Dune-devel mailing list<br>
> <a href="mailto:Dune-devel@dune-project.org">Dune-devel@dune-project.org</a><br>
> <a href="http://lists.dune-project.org/mailman/listinfo/dune-devel" rel="noreferrer" target="_blank">http://lists.dune-project.org/mailman/listinfo/dune-devel</a><br>
><br>
<br>
</div></div><br>_______________________________________________<br>
Dune-devel mailing list<br>
<a href="mailto:Dune-devel@dune-project.org">Dune-devel@dune-project.org</a><br>
<a href="http://lists.dune-project.org/mailman/listinfo/dune-devel" rel="noreferrer" target="_blank">http://lists.dune-project.org/mailman/listinfo/dune-devel</a><br>
<br></blockquote></div><br></div>