W3C home > Mailing lists > Public > public-i18n-archive@w3.org > October to December 2015

Re: [alreq] Applying a unified style to the document

From: r12a via GitHub <sysbot+gh@w3.org>
Date: Tue, 24 Nov 2015 15:58:21 +0000
To: public-i18n-archive@w3.org
Message-ID: <issue_comment.created-159312767-1448380701-sysbot+gh@w3.org>
i struggled with how to represent rtl text in examples when writing 
the educational articles on the w3c site.  I think the article at 
http://www.w3.org/International/articles/inline-bidi-markup/ shows my 
approach at its most evolved state - see the explanation in the purple
 box and look at the examples to see whether they look workable.

we're about to move to a new document style that imposes a 50em max 
width on the main text column, although if needed we should be able to
 use wider tables and diagrams.  That should give you a rule of thumb 
for the overall size.  Any caption text should be in the caption 
element.  It would be good to keep other explanatory text in an image 
to a minimum.  For Arabic text, i recommend a size that is big enough 
for non-arabic-using people to clearly see what's going on.

it is possible to use SVG (it's used already in the clreq and tlreq 

in W3C docs it is common to use [DOCNAME] type links to the references
 section.  I never thought this was very helpful. It springs from 
academic rather than practical sources.  I recommend that links in the
 document link directly to the document being cited, and to the 
relevant place inside that document.  We can also use the [DOCNAME] 
links to provide information about the name of the document, if 

here's a style guide that you may find useful 
http://www.w3.org/International/docs/styleguide.  See also the respec 
guidelines (esp. for things like linking to definitions, figures, 
etc.) https://www.w3.org/respec/ref.html

hope that helps

GitHub Notification of comment by r12a
Please view or discuss this issue at 
https://github.com/w3c/alreq/issues/13#issuecomment-159312767 using 
your GitHub account
Received on Tuesday, 24 November 2015 15:58:29 UTC

This archive was generated by hypermail 2.4.0 : Monday, 4 July 2022 18:09:34 UTC