Hi,

I've added a new set of targets for the manual, in preparation of a
manual version for the XO version of Csound. There are new html and pdf
targets for the XO, though not much changes have been made there. The
main addition is a css file csoundXO.css. You can try this css by
renaming it to csound.css and placing it in the html manual directory to
see how the manual would look (remember to keep the original csound.css
file, in case you want to go back).

I think this css would be a good change for the canonical manual as
well, so let mw know what you like/don't like.

Cheers,
Andrés



-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lis

Andrés,

I really like the look and feel of this new css and I think it would  
be nice for
the canonical manual as well.

-dB

On Feb 20, 2008, at 3:40 PM, Andres Cabrera wrote:

> Hi,
>
> I've added a new set of targets for the manual, in preparation of a
> manual version for the XO version of Csound. There are new html and  
> pdf
> targets for the XO, though not much changes have been made there. The
> main addition is a css file csoundXO.css. You can try this css by
> renaming it to csound.css and placing it in the html manual  
> directory to
> see how the manual would look (remember to keep the original  
> csound.css
> file, in case you want to go back).
>
> I think this css would be a good change for the canonical manual as
> well, so let mw know what you like/don't like.
>
> Cheers,
> Andrés
>
>
>
> ---------------------------------------------------------------------- 
> ---
> This SF.net email is sponsored by: Microsoft
> Defy all challenges. Microsoft(R) Visual Studio 2008.
> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> _______________________________________________
> Csound-devel mailing list
> Csound-devel@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/csound-devel


-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net

Me too, it looks really nice.

> Andrés,
>
> I really like the look and feel of this new css and I think it would
> be nice for
> the canonical manual as well.
>
> -dB
>
> On Feb 20, 2008, at 3:40 PM, Andres Cabrera wrote:
>
>> Hi,
>>
>> I've added a new set of targets for the manual, in preparation of a
>> manual version for the XO version of Csound. There are new html and
>> pdf
>> targets for the XO, though not much changes have been made there. The
>> main addition is a css file csoundXO.css. You can try this css by
>> renaming it to csound.css and placing it in the html manual
>> directory to
>> see how the manual would look (remember to keep the original
>> csound.css
>> file, in case you want to go back).
>>
>> I think this css would be a good change for the canonical manual as
>> well, so let mw know what you like/don't like.
>>
>> Cheers,
>> Andrés
>>
>>
>>
>> ----------------------------------------------------------------------
>> ---
>> This SF.net email is sponsored by: Microsoft
>> Defy all challenges. Microsoft(R) Visual Studio 2008.
>> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>> _______________________________________________
>> Csound-devel mailing list
>> Csound-devel@lists.sourceforge.net
>> https://lists.sourceforge.net/lists/listinfo/csound-devel
>
>
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Microsoft
> Defy all challenges. Microsoft(R) Visual Studio 2008.
> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> _______________________________________________
> Csound-devel mailing list
> Csound-devel@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/csound-devel
>



-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net

I'm probably going to go the way of no indentation on this one. 
Indentation does make it a little less readable in my opinion. 
Everything else looks great, it's nice to have more colour in the manual!

Rory.


Andres Cabrera wrote:
> Hi Steven,
> 
> I'm loosely basing the idea on the max/msp docs, which were suggested
> some time ago as a good starting point, but I'm taking votes now =)
> 
> Who wants indentation?
> 
> Cheers,
> Andrés
> 
> On Thu, Feb 21, 2008 at 7:27 PM, Steven Yi  wrote:
>> Hi Andres,
>>
>>  Sorry to disappoint but I'm hoping for no indentation. :P  I think
>>  most documentation I've seen doesn't use any indentation and it's
>>  easier for me to read that way.  But I'm only one person's opinion so
>>  if please confirm with others! =)
>>
>>  steven
>>
>>
>>
>>
>>  On Thu, Feb 21, 2008 at 3:04 PM, Andres Cabrera  wrote:
>>  > Hi All,
>>  >
>>  >  Thanks for the feedback. I'll enlarge the paragraph font a bit, it is
>>  >  a bit on the small side, though it looks OK in Firefox in Ubuntu.
>>  >  Steven, I want to indent something =)... Do you think indenting the
>>  >  paragraphs would be better?
>>  >
>>  >  Cheers,
>>  >  Andrés
>>  >
>>  >
>>  >
>>  >  On Thu, Feb 21, 2008 at 2:15 PM, Steven Yi  wrote:
>>  >  > Hi Andres,
>>  >  >
>>  >  >  I'll chime in to say that the font size used for the normal text seems
>>  >  >  really small to me and out of proportion to the size of the text
>>  >  >  elsewhere.  Also, the indentation of subheaders seems off in the
>>  >  >  opcode entries (i.e. http://www.mentelibre.info/htmlXO/outipb.html).
>>  >  >  I think I'd rather prefer it flush left as it is in the current manual
>>  >  >  (http://csounds.com/manual/html/outipb.html).
>>  >  >
>>  >  >  Thanks!
>>  >  >  steven
>>  >  >
>>  >  >
>>  >  >
>>  >  >  On Thu, Feb 21, 2008 at 3:01 AM, Rory Walsh  wrote:
>>  >  >  > Me too, it looks really nice.
>>  >  >  >
>>  >  >  >
>>  >  >  >
>>  >  >  >  > Andrés,
>>  >  >  >  >
>>  >  >  >  > I really like the look and feel of this new css and I think it would
>>  >  >  >  > be nice for
>>  >  >  >  > the canonical manual as well.
>>  >  >  >  >
>>  >  >  >  > -dB
>>  >  >  >  >
>>  >  >  >  > On Feb 20, 2008, at 3:40 PM, Andres Cabrera wrote:
>>  >  >  >  >
>>  >  >  >  >> Hi,
>>  >  >  >  >>
>>  >  >  >  >> I've added a new set of targets for the manual, in preparation of a
>>  >  >  >  >> manual version for the XO version of Csound. There are new html and
>>  >  >  >  >> pdf
>>  >  >  >  >> targets for the XO, though not much changes have been made there. The
>>  >  >  >  >> main addition is a css file csoundXO.css. You can try this css by
>>  >  >  >  >> renaming it to csound.css and placing it in the html manual
>>  >  >  >  >> directory to
>>  >  >  >  >> see how the manual would look (remember to keep the original
>>  >  >  >  >> csound.css
>>  >  >  >  >> file, in case you want to go back).
>>  >  >  >  >>
>>  >  >  >  >> I think this css would be a good change for the canonical manual as
>>  >  >  >  >> well, so let mw know what you like/don't like.
>>  >  >  >  >>
>>  >  >  >  >> Cheers,
>>  >  >  >  >> Andrés
>>  >  >  >  >>
>>  >  >  >  >>
>>  >  >  >  >>
>>  >  >  >  >> ----------------------------------------------------------------------
>>  >  >  >  >> ---
>>  >  >  >  >> This SF.net email is sponsored by: Microsoft
>>  >  >  >  >> Defy all challenges. Microsoft(R) Visual Studio 2008.
>>  >  >  >  >> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>>  >  >  >  >> _______________________________________________
>>  >  >  >  >> Csound-devel mailing list
>>  >  >  >  >> Csound-devel@lists.sourceforge.net
>>  >  >  >  >> https://lists.sourceforge.net/lists/listinfo/csound-devel
>>  >  >  >  >
>>  >  >  >  >
>>  >  >  >  > -------------------------------------------------------------------------
>>  >  >  >  > This SF.net email is sponsored by: Microsoft
>>  >  >  >  > Defy all challenges. Microsoft(R) Visual Studio 2008.
>>  >  >  >  > http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>>  >  >  >  > _______________________________________________
>>  >  >  >  > Csound-devel mailing list
>>  >  >  >  > Csound-devel@lists.sourceforge.net
>>  >  >  >  > https://lists.sourceforge.net/lists/listinfo/csound-devel
>>  >  >  >  >
>>  >  >  >
>>  >  >  >
>>  >  >  >
>>  >  >  >  -------------------------------------------------------------------------
>>  >  >  >
>>  >  >  >
>>  >  >  > This SF.net email is sponsored by: Microsoft
>>  >  >  >  Defy all challenges. Microsoft(R) Visual Studio 2008.
>>  >  >  >  http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>>  >  >  >  _______________________________________________
>>  >  >  >  Csound-devel mailing list
>>  >  >  >  Csound-devel@lists.sourceforge.net
>>  >  >  >  https://lists.sourceforge.net/lists/listinfo/csound-devel
>>  >  >  >
>>  >  >
>>  >  >  -------------------------------------------------------------------------
>>  >
>>  >
>>  > >
>>  >  >
>>  >  > This SF.net email is sponsored by: Microsoft
>>  >  >  Defy all challenges. Microsoft(R) Visual Studio 2008.
>>  >  >  http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>>  >  >  _______________________________________________
>>  >  >  Csound-devel mailing list
>>  >  >  Csound-devel@lists.sourceforge.net
>>  >  >  https://lists.sourceforge.net/lists/listinfo/csound-devel
>>  >  >
>>  >
>>  >  -------------------------------------------------------------------------
>>
>>
>>>  This SF.net email is sponsored by: Microsoft
>>  >  Defy all challenges. Microsoft(R) Visual Studio 2008.
>>  >  http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>>  >  _______________________________________________
>>  >  Csound-devel mailing list
>>  >  Csound-devel@lists.sourceforge.net
>>  >  https://lists.sourceforge.net/lists/listinfo/csound-devel
>>  >
>>
>>  -------------------------------------------------------------------------
>>  This SF.net email is sponsored by: Microsoft
>>  Defy all challenges. Microsoft(R) Visual Studio 2008.
>>  http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
>>  _______________________________________________
>>  Csound-devel mailing list
>>  Csound-devel@lists.sourceforge.net
>>  https://lists.sourceforge.net/lists/listinfo/csound-devel
>>
> 
> -------------------------------------------------------------------------
> This SF.net email is sponsored by: Microsoft
> Defy all challenges. Microsoft(R) Visual Studio 2008.
> http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
> _______________________________________________
> Csound-devel mailing list
> Csound-devel@lists.sourceforge.net
> https://lists.sourceforge.net/lists/listinfo/csound-devel
> 

-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net

I think the new look is a major improvement.  I've felt for a long time that
Csound related content has looked dated, and design upgrades like this can
only help improve perceptions of Csound.

That being said, I agree that the indentation should be restored so it is
flush with the rest of the text.  I also agree that the text size is most
likely too small, at least for non-XO computers.  I have one other (trivial)
suggestion, so take with a grain of salt.  I would ditch the remaining serif
fonts in favor of sans-serif, as they tend to be a easier to read on
computer screens.  I personally fancy Verdana.  :)

Like I said, it's still a major improvement, and if things were to stay the
way they are, I'd be more than happy.

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



rory walsh wrote:
> 
> I'm probably going to go the way of no indentation on this one. 
> Indentation does make it a little less readable in my opinion. 
> Everything else looks great, it's nice to have more colour in the manual!
> 

-- 
View this message in context: http://www.nabble.com/CsoundXO-manual-tp15598419p15634015.html
Sent from the Csound - Dev mailing list archive at Nabble.com.


-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net