[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kdevelop-devel
Subject:    Re: proposal for kdevelop.org new website design
From:       "Sam S." <smls75 () gmail ! com>
Date:       2010-05-17 16:56:24
Message-ID: AANLkTinKewuwsT5PtX68aNWsOTYpZA6W6svfPgpxgEjO () mail ! gmail ! com
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]


In the PressOn Sun, May 16, 2010 at 23:46, Amilcar do Carmo Lucas wrote:
> [...]
> Can we keep the moduleentry() function call and change its contents  to
> <h1></h1> ?
> I would hate to have to change all the pages + translated pages.

What if I did it? :-)
Surely it must be possible to semi-automate this task...

On Mon, May 17, 2010 at 12:21 AM, Niko Sams <niko.sams@gmail.com> wrote:
> I heavily modified it already, it's actually quite nice no have a
> single function
> to change....

The problem is that the "*<moduleentry><h1>TITLE</h1><div>CONTENT</div></**
moduleentry**>*" of the old style (which the module_head()/module_tail() php
functions provided) doesn't map one-to-one with any single piece of markup
that cleanly satisfies all possibilities encountered in the new style...
Depending on the situation, the new style would ideally want that markup
replaced by:

   1. "*<h1>TITLE</h1> CONTENT*" (the first section of most pages other than
   the main page, e.g. "Logos and Banners" page)
   2. "*<h2>TITLE</h2> CONTENT*" (subsections on various pages, e.g. the
   news section on the front page)
   3. "*<box>CONTENT</box>*" (e.g. the "what is KDevelop" box on the front
   page) ["<box></box>" is meant to symbolize the markup needed for the
   "Important content" boxes]
   4. "*<h2>TITLE></h2> <box>CONTENT</box>*" (e.g. the "KDev3 vs KDev4" box
   on the front page)

Niko already tried to accommodate multiple (but not all) of these cases in a
unified way, but it'll only get messier and messier.
That's why I think the best solution would be to edit the HTML files and
just replace those php function calls by whatever <h1></h1> / <h2></h2> /
etc. markup is actually needed in each situation.

It would of course make sense to use appropriate php functions for
generating the markup of *actual boxes* (i.e., pieces of content which are
actually graphically styled boxes in the new design), though.
I've committed an updated theme4.php that deprecates module_head()/
module_tail() and defines box_head()/box_tail() (for graphically styled
content boxes like on the front page), as well as linkbox_head()/
linkbox_tail() (for the link boxes, as these need different markup). [The
commit is self-contained and touches only this one file, so it should be
easy to revert if you don't want this.]

Anyhow, with this, *all* occurences of module_head()/module_tail() can be
nicely replaced by different combinations of <h1>'s, <h2>'s and the
aforementioned new box functions.
For example, the "KDev3 vs KDev4" section,
"<?php module_head('Versions:', 'border main-versions');?> ... <?php
module_tail();?>"
would become:
"<h2>Versions:</h2> <?php box_head('border main-versions');?> ... <?php
box_tail();?>"

[Attachment #5 (text/html)]

<h3>In the Press</h3>On Sun, May 16, 2010 at 23:46, Amilcar do Carmo Lucas \
wrote:<br>&gt; [...]<br>&gt; Can we keep the moduleentry() function call and change \
its contents  to<br>&gt; &lt;h1&gt;&lt;/h1&gt; ?<br>&gt; I would hate to have to \
change all the pages + translated pages.<br> <br>What if I did it? :-)<br>Surely it \
must be possible to semi-automate this task...<br><br>On Mon, May 17, 2010 at 12:21 \
AM, Niko Sams &lt;<a href="mailto:niko.sams@gmail.com">niko.sams@gmail.com</a>&gt; \
wrote:<br>&gt; I heavily modified it already, it&#39;s actually quite nice no have \
a<br> &gt; single function<br>&gt; to change....<br><br>The problem is that the \
&quot;<b>&lt;moduleentry&gt;&lt;h1&gt;TITLE&lt;/h1&gt;&lt;div&gt;CONTENT&lt;/div&gt;&lt;/</b><b>moduleentry</b><b>&gt;</b>&quot; \
of the old style (which the <span style="font-family: courier \
new,monospace;">module_head</span><span style="font-family: courier \
new,monospace;">()</span>/<span style="font-family: courier \
new,monospace;">module_tail</span><span style="font-family: courier \
new,monospace;">()</span> php functions provided) doesn&#39;t map one-to-one with any \
single piece of markup that cleanly satisfies all possibilities encountered in the \
new style...<br> Depending on the situation, the new style would ideally want that \
markup replaced by:<br><ol><li>&quot;<b>&lt;h1&gt;TITLE&lt;/h1&gt; CONTENT</b>&quot; \
(the first section of most pages other than the main page, e.g. &quot;Logos and \
Banners&quot; page)<br> </li><li>&quot;<b>&lt;h2&gt;TITLE&lt;/h2&gt; \
CONTENT</b>&quot; (subsections on various pages, e.g. the news section on the front \
page)</li><li>&quot;<b>&lt;box&gt;CONTENT&lt;/box&gt;</b>&quot; (e.g. the &quot;what \
is KDevelop&quot; box on the front page) [&quot;&lt;box&gt;&lt;/box&gt;&quot; is \
meant to symbolize the markup needed for the &quot;Important content&quot; boxes]<br> \
</li><li>&quot;<b>&lt;h2&gt;TITLE&gt;&lt;/h2&gt; \
&lt;box&gt;CONTENT&lt;/box&gt;</b>&quot; (e.g. the &quot;KDev3 vs KDev4&quot; box  on \
the front page)</li></ol>Niko already tried to accommodate multiple (but not all) of \
these cases in a unified way, but it&#39;ll only get messier and \
messier.<br>That&#39;s why I think the best solution would be to edit the HTML files \
and just replace those php function calls by whatever &lt;h1&gt;&lt;/h1&gt; / \
&lt;h2&gt;&lt;/h2&gt; / etc. markup is actually needed in each situation.<br> <br>It \
would of course make sense to use appropriate php functions for generating the markup \
of <i>actual boxes</i> (i.e., pieces of content which are actually graphically styled \
boxes in the new design), though.<br>I&#39;ve committed an updated theme4.php that \
deprecates <span style="font-family: courier new,monospace;">module_head</span><span \
style="font-family: courier new,monospace;">()</span>/<span style="font-family: \
courier new,monospace;">module_tail</span><span style="font-family: courier \
new,monospace;">()</span> and defines <span style="font-family: courier \
new,monospace;">box_head()</span>/<span style="font-family: courier \
new,monospace;">box_tail()</span> (for graphically styled content boxes like on the \
front page), as well as <span style="font-family: courier \
new,monospace;">linkbox_head()</span>/<span style="font-family: courier \
new,monospace;">linkbox_tail()</span> (for the link boxes, as these need different \
markup). [The commit is self-contained and touches only this one file, so it should \
be easy to revert if you don&#39;t want this.]<br> <br>Anyhow, with this, *all* \
occurences of <span style="font-family: courier \
new,monospace;">module_head</span><span style="font-family: courier \
new,monospace;">()</span>/<span style="font-family: courier \
new,monospace;">module_tail</span><span style="font-family: courier \
new,monospace;">()</span> can be nicely replaced by different combinations of \
&lt;h1&gt;&#39;s, &lt;h2&gt;&#39;s and the aforementioned new box functions.<br> For \
example, the &quot;KDev3 vs KDev4&quot; section,<br>&quot;<span style="font-family: \
courier new,monospace;">&lt;?php module_head(&#39;Versions:&#39;, &#39;border \
main-versions&#39;);?&gt; ... &lt;?php module_tail();?&gt;</span>&quot;<br> would \
become:<br>&quot;<span style="font-family: courier \
new,monospace;">&lt;h2&gt;</span><span style="font-family: courier \
new,monospace;">Versions:</span><span style="font-family: courier \
new,monospace;">&lt;/h2&gt;</span><span style="font-family: courier new,monospace;"> \
&lt;?php box_head(&#39;border </span><span style="font-family: courier \
new,monospace;">main-versions</span><span style="font-family: courier \
new,monospace;">&#39;);?&gt; ... &lt;?php box_tail();?&gt;</span>&quot;<br> <br>



-- 
KDevelop-devel mailing list
KDevelop-devel@kdevelop.org
https://barney.cs.uni-potsdam.de/mailman/listinfo/kdevelop-devel


[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic