Re: [Dclib-devel] dlib web page question

[Davis K. <dav...@us...>]

I actually made the tools for the dlib webpage myself.  All of it is in
subversion in the trunk/docs (
http://dclib.svn.sourceforge.net/viewvc/dclib/trunk/docs/) folder.   The
documentation is basically just a bunch of XML files and an XSLT stylesheet
I wrote that turns those XML files into HTML.  The stylesheet and XML
documents are in the trunk/docs/docs folder.   There is also the C++ pretty
printer that turns code into HTML and that is another program I made.  It is
in the trunk/docs/htmlify folder.  And to put it all together there are some
shell scripts in the trunk/docs folder.  Specifically, the
trunk/docs/makedocs script runs everything and generates the webpage using
the htmlify program and the XML files.

Anyway, the most important part is the XSLT stylesheet since it is what
turns the XML into the actual web pages you see.  For example, if you open
the trunk/docs/docs/index.xml file in firefox or IE you will see it
displayed as a web page.  But if you look at it in notepad or some other
text editor you will see that it is just XML with a thing at the top that
says "use the stylesheet to display this as a webpage."

So if you want to use the documentation stuff I would recommend pulling the
contents out of subversion and trying to get that setup to your liking.
Also, at the top of the stylesheet file there is the following (at line 14
and 15):
       <!-- This is the ID you get from Google Webmaster Tools -->
       <xsl:variable
name="google_verify_id">02MiiaFNVzS5/u0eQhsy3/knioFHsia1X3DXRpHkE6I=</xsl:variable>
You should probably delete this or set it up with your own google webmaster
tools id.


As for design by contract, you can read about my take on in with respect to
dlib here (http://dclib.sourceforge.net/howto_contribute.html#1).  There is
also a good description of it at the eiffel site (
http://archive.eiffel.com/doc/manuals/technology/contract/).   As for any
books on the subject, the best is probably Object-Oriented Software
Construction by Bertrand Meyer.

If you have any other questions feel free to ask :)

Cheers,
Davis

On Wed, Feb 11, 2009 at 9:07 AM, guildivernos guildivernos <
gui...@gm...> wrote:

> Hi
>
> I want to know wich tools did you use to build your web page (
> http://dclib.sourceforge.net/index.html). I really like it and want to do
> something similar for my page. I'm also looking at dlib for my C++ projects,
> desing by contract looks very nice, I will try to learn it. Do you have any
> books/Documents to recomend ?
>
>
> Hope you can help me
> Sorry for my english.
>
> Great work !!!
>
> Ramiro de Zavalia
>