Re: New LilyPond website

[John Roper]

Ok, I tested, and I made some more fixes.

On Wed, Nov 30, 2016 at 9:18 PM, John Roper <address@hidden> wrote:
> Ok, here are my updates on the lilypond-website.css.
>
> On Wed, Nov 30, 2016 at 8:53 PM, Paul <address@hidden> wrote:
>> On 11/30/2016 08:01 PM, John Roper wrote:
>>
>>> Why is the website auto generated? What content is auto generated or
>>> is it just setup that way so that it is always built to the latest
>>> version for releases?
>>
>>
>> Others can probably give better answers, as this is kind of second hand
>> based on past discussions... but the website is basically an appendage to
>> the (much larger) documentation, and, well let me quote
>>
>> https://www.gnu.org/software/texinfo/
>>
>> -------------------
>> Texinfo is the official documentation format of the GNU project. It was
>> invented by Richard Stallman and Bob Chassell many years ago, loosely based
>> on Brian Reid's Scribe and other formatting languages of the time. It is
>> used by many non-GNU projects as well.
>>
>> Texinfo uses a single source file to produce output in a number of formats,
>> both online and printed (dvi, html, info, pdf, xml, etc.). This means that
>> instead of writing different documents for online information and another
>> for a printed manual, you need write only one document. And when the work is
>> revised, you need revise only that one document. The Texinfo system is
>> well-integrated with GNU Emacs.
>> -------------------
>>
>> So using texinfo to produce the documentation in info, pdf, html formats
>> etc. is then also used for the website.  I think that's the main reason, but
>> it's also tied up with supporting multiple translations of the docs/website
>> and how building the docs runs LilyPond to generate all of the images for
>> the examples, etc.  Also the argument is that having one system for docs and
>> website is simpler and makes maintenance easier, especially with fewer
>> contributors, etc.  That's the gist of past discussions.
>>
>> I think there's a case for decoupling the website from the documentation to
>> a greater degree, e.g. as Federico argued earlier in the thread, but based
>> on past discussions I am not optimistic that this would go as far as not
>> using texinfo.  (But I've often wondered how important is it for the content
>> of the website to be available in pdf and info formats.)
>>
>> Upgrading to the latest version of texi2any[0] and/or using Haunt would
>> help, but those are non-trivial endeavors.  The current setup certainly
>> introduces friction for website work, especially for those who are used to
>> working directly with HTML.
>>
>> [0]
>> https://www.gnu.org/software/texinfo/manual/texinfo/html_node/Generic-Translator-texi2any.html
>>
>> Cheers,
>> -Paul
>>
>
>
>
> --
> John Roper
> Freelance Developer and Simulation Artist
> Boston, MA USA
> http://jmroper.com/



-- 
John Roper
Freelance Developer and Simulation Artist
Boston, MA USA
http://jmroper.com/

lilypond-website.css
Description: Text Data