[Dune-devel] New Website

[Dominic Kempf]

Hey everyone,

I have now integrated the Sphinx build system documentation into the new
website
and its automated build process.

Check https://beta.dune-project.org/buildsystem/

The documentation is rebuilt nightly together with the doxygen docs.
Note, that I fell back to using iframes instead of doing the painful
thing of mixing css styles again. To be honest, I think this could be the
way
to go for doxygen, too. It definitely is for the user wiki.

Best,
Dominic

PS: Some Color customization of the Sphinx theme can still be done
(in conf.py.in dune.common/cmake/scripts/). Have a look at available
values here:
http://alabaster.readthedocs.io/en/latest/customization.html#style-colors

On Wed, May 25, 2016 at 3:06 PM, Dominic Kempf <dominic.r.kempf at gmail.com>
wrote:

> For everybody interested in fixing doxygen, I have documented
> dune-website-builder and made it much easier to run it locally.
>
> Dominic
>
> On Wed, May 25, 2016 at 11:22 AM, Dominic Kempf <dominic.r.kempf at gmail.com
> > wrote:
>
>> Hey everybody,
>>
>> sorry for being so quite, but I was on vacation as Steffen pointed out.
>>
>> I am happy to answer a few of your questions:
>>
>> Local builds: dune-website-builder can be run locally, I will write a
>> meaningful README later today.
>>
>> Mathjax formulae: Rene and me will dig into that, please be patient.
>>
>> Sphinx: It is on my TODO list to add the sphinx docs to the auto build,
>> just as doxygen is.
>>
>> Syncing content: Any help appreciated! If you start something big, maybe
>> announce it beforehand on the list.
>>
>> users.dune-project.org: I will contact Rene Milk to find out what needs
>> to be done.
>>
>> How to include projects into doxygen doc: Acutally, I already docuemented
>> this in the dune-website
>> README, which forwards to archetypes/modules.md. The comments in the
>> frontmatter explains
>> how to specify that a documentation is to be built.
>>
>> I hope that answers some questions,
>> Dominic
>>
>> On Mon, May 23, 2016 at 5:07 PM, Christian Engwer <
>> christian.engwer at uni-muenster.de> wrote:
>>
>>> On Mon, May 23, 2016 at 05:03:36PM +0200, Christoph Grüninger wrote:
>>> > Hi Steffen,
>>> > I like your plan. Three questions remain so far. What about the
>>> build-system documentation created by Sphinx? Will somebody from Heidelberg
>>> sync the contents (news, changelog etc.) or should we help? Can we (I'll do
>>> if nobody objects) include the SVG instead of the PNG for the structure of
>>> Dune?
>>> > Both are no show stoppers.
>>>
>>> Regarding the Sphinx documentation, this might also be a nice option
>>> for doxygen... there is bridge code to transfrom (I think) doxygen XML
>>> to Sphinx-Input. This would reduce the amount of different tools we
>>> need to "style".
>>>
>>> And an other thing... what about users.dune-project.org ... I forgot
>>> how they get styled... but somehow users adapts to (some) changes on
>>> the main web-site.
>>>
>>> Christian
>>>
>>> >
>>> > Bye
>>> > Christoph
>>> >
>>> > > Am 23.05.2016 um 15:01 schrieb Steffen Müthing <
>>> steffen.muething at iwr.uni-heidelberg.de>:
>>> > >
>>> > > Hi everyone,
>>> > >
>>> > > as a continuation from my post to the general mailing list:
>>> > >
>>> > > I would like to completely switch over to the new website as soon as
>>> possible. That way,
>>> > > people will notice the new site (and maybe fix some of the remaining
>>> layout / design issues ;-) ).
>>> > >
>>> > > Moreover, having two sites that keep diverging is not a good state
>>> of affairs.
>>> > >
>>> > > Are there any major concerns by any of the core developers?
>>> Otherwise, I will switch dune-project.org
>>> > > and www.dune-project.org to the new site and move a final snapshot
>>> of the old website to website-archive.dune-project.org
>>> > > at the end of the week.
>>> > >
>>> > > Any comments / questions?
>>> > >
>>> > > Best
>>> > > Steffen
>>> > > _______________________________________________
>>> > > Dune-devel mailing list
>>> > > Dune-devel at dune-project.org
>>> > > http://lists.dune-project.org/mailman/listinfo/dune-devel
>>> >
>>> >
>>> > _______________________________________________
>>> > Dune-devel mailing list
>>> > Dune-devel at dune-project.org
>>> > http://lists.dune-project.org/mailman/listinfo/dune-devel
>>>
>>> --
>>> Prof. Dr. Christian Engwer
>>> Institut für Numerische und Angewandte Mathematik
>>> Fachbereich Mathematik und Informatik der Universität Münster
>>> Einsteinstrasse 62
>>> 48149 Münster
>>>
>>> E-Mail  christian.engwer at uni-muenster.de
>>> Telefon +49 251 83-35067
>>> FAX     +49 251 83-32729
>>>
>>> _______________________________________________
>>> Dune-devel mailing list
>>> Dune-devel at dune-project.org
>>> http://lists.dune-project.org/mailman/listinfo/dune-devel
>>>
>>
>>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.dune-project.org/pipermail/dune-devel/attachments/20160530/19bc32f7/attachment.htm>