[Dune-devel] New Website

Tue May 31 11:30:55 CEST 2016

On 31.05.2016 10:44, Dominic Kempf wrote:
> Hmm, that is true. I can live with that for the buildsystem doc, but not
> for the user wiki.
> Unfortunately, I see no proper solution right now...
> 
> Dominic
> 
> On Tue, May 31, 2016 at 8:59 AM, Christian Engwer <
> christian.engwer at uni-muenster.de> wrote:
> 
>> Dear all,
>>
>>> 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.
>>
>> I stringly disagree. iframes break deep links, which is somethign we
>> definitely want, e.g. the link to the reference element documentation
>> we link from the web-site.
>> In particular for the user wiki we need deep links, otherwise we can
>> not link to project repositories or documentation in the wiki. As the
>> startpage of redmine is so cluttered, I even dare to say that the use
>> wiki is only useful if we can link to it.
>>
>> Christian
>>
>>
>>> 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
>>>>>>
>>>>>
>>>>>
>>>>
>>
>> --
>> 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
> 
Well, what functionality does the user wiki provide that the gitlab
instance does not? Why do we still need both? If there's no good answer
to that we could just see about transitioning projects and get rid of
the userwiki entirely.


-- 
--------------------------------------------------
 Dipl.-Math. René Milk
 University of Münster
 Institute for Applied Mathematics
 Orleans-Ring 10, R. 120.012
 48149 Münster               Tel. +49 251 83-35131
 Germany
--------------------------------------------------