Hi Everybody!

For some reason, I started playing with the CSS properties of the Csound
manual this morning, and before too long I had come up with a 95% functional
skin.  Here's the file:

http://www.thumbuki.com/csound/files/mailinglist/CsoundMan5.06SkinPrototype.zip


It's not perfect, not by a long shot.  However, it's a good start for anyone
else wishing to customize their Csound environment.  It's only been tested
in Safari on OS X, so I make no guarantees on how well it will work on other
browsers/systems.

The maintainers of the manual have done an excellent job in providing the
necessary css classes to make skins possible.  Is there any interest in the
community in customing the visual aesthetics of Csound?

Best, 
Jake 

---- 
The Csound Blog 
http://www.thumbuki.com/csound/blog


-- 
View this message in context: http://www.nabble.com/CSound-Manual-Skin-tf4166942.html#a11855237
Sent from the Csound - General mailing list archive at Nabble.com.

I know nothing about css, what do you do with it?

Jacob Joaquin wrote:
> Hi Everybody!
> 
> For some reason, I started playing with the CSS properties of the Csound
> manual this morning, and before too long I had come up with a 95% functional
> skin.  Here's the file:
> 
> http://www.thumbuki.com/csound/files/mailinglist/CsoundMan5.06SkinPrototype.zip
> 
> 
> It's not perfect, not by a long shot.  However, it's a good start for anyone
> else wishing to customize their Csound environment.  It's only been tested
> in Safari on OS X, so I make no guarantees on how well it will work on other
> browsers/systems.
> 
> The maintainers of the manual have done an excellent job in providing the
> necessary css classes to make skins possible.  Is there any interest in the
> community in customing the visual aesthetics of Csound?
> 
> Best, 
> Jake 
> 
> ---- 
> The Csound Blog 
> http://www.thumbuki.com/csound/blog
> 
> 

The only file I modified is csound.css.  That, and I added a few extra images
used by the skin.  I did put a little thought into maintenance issues, and
came up with a basic file hierarchy for organizing skins.  Here's the
example from CsoundMan5.06SkinPrototype.zip:


csound.css/
skins/ - all skins would be stored in a subfolder here
skins/original/
skins/original/csound.css  - the original css included with 5.06 manual
skins/prototype/ - the prototype skin folder
skins/prototype/csound.css/
skins/prototype/images/
skins/prototype/images/body.gif
skins/prototype/images/header.jpg
skins/prototype/images/tile.png


The skin isn't near ready for prime time.  There are still quite a fewplaces
where the formatting is incorrect, and I'll have to go back and proof every
single page multiple times to catch all the bugs. I also agree with Steven
that this skin is not at all appropriate for use as a default skin.  This is
more or less a demonstration of what is already possible.

If there is interest in adding multiple skin support to manual, I would
gladly help out anyway I can.  However, I think official support might be a
little premature at this stage as csounders can already make and use skins. 
Though skin support might be a nice upgrade down the road.  I'll continue
working on my skin a little bit, see how things evolve.  If anyone else
wants to explore the idea of creating custom templates for the manual, that
would be great, too.

I uploaded the prototype csound.css file by itself, as requested:

http://www.thumbuki.com/csound/files/mailinglist/csound.css


Best, 
Jake 

---- 
The Csound Blog 
http://www.thumbuki.com/csound/blog 





Andres Cabrera wrote:
> 
> Hi Jake,
> I haven't had time to have a look, but have you modified more than the
> css? If not, then I can add it to the manual. If you have modified
> more, we'll have to think about maintenance issues...
> 
> can you post just the css?
> 
> Chris: css is a stylesheet file which tells the manual pages how they
> should format themselves. In other words, the appearance is not coded
> inside the pages themselves, but on an external file, so if you modify
> that file, you modify the appearance of the whole manual. See
> Wikipedia for more.
> 
> Cheers,
> Andres
> 

-- 
View this message in context: http://www.nabble.com/CSound-Manual-Skin-tf4166942.html#a11866451
Sent from the Csound - General mailing list archive at Nabble.com.