Hebrew in markup

[Tzafrir Cohen]

Thanks for your answer,

On Sat, Mar 07, 2015 at 11:14:39AM +0200, Eli Zaretskii wrote:
> > Date: Sat, 7 Mar 2015 02:42:48 +0100
> > From: Tzafrir Cohen <tzafrir at cohens.org.il>
> > 
> > I'd like to write a Heberw document, get a nice result HTML and still be
> > able to save the source in proper version control.
> > 
> > I could use raw HTML, but there are better options nowadays - asciidoc,
> > markdown (various implementations), reSt, and such.
> > 
> > But I could not figure a simple way with any of those to get decent
> > control of bidi. Or specifically:
> > 
> > * Make the whole document RTL
> > * Make various paragraphs LTR
> > 
> > I guess I need to override some styles. With asciidoc I could not find a
> > simple way to do that and ended up having to create my own separate
> > "bidi" style. I didn't yet check all the various reSt and markdown
> > implementations. Any better alternatives?
> 
> Emacs, of course.
> 
> You can make the whole document RTL by setting a buffer-local
> variable.  

How do I make this variable part of the document?

> You also leave the overall direction dynamic and control
> each paragraph's direction with the first strong directional character
> of the paragraph, or with LRM/RLM if the first character is not what
> you need.
> 
> For HTML, translate those into the corresponding dir= directives.

How do I translate a document to HTML from the command line?

BTW: something I read a while ago on Planet GNOME:

http://thedocsbook.org/blog/2015-02-23-reflecting-on-feedback/

"In terms of modifying the appearance of our help, their technical
writers found it difficult to modify the CSS that we use. Cosimo noted
that the CSS for our help is not stored in a single file, nor even a
single directory - it's partly embedded in Yelp's XSLT.

While not always ideal, there are reasons for this. For example, if a
person's visual impairment requires that they use GNOME's High Contrast
GTK theme, Yelp will pick up the theme change and will use a
corresponding color scheme when it renders the help for that user.
Similarly, if a user sets their default system language to a
Right-to-Left-based language (such as Arabic), Yelp will also pick up
that change, and will display the help in the appropriate Right-to-Left
manner automatically."

-- 
Tzafrir Cohen         | tzafrir at jabber.org | VIM is
http://tzafrir.org.il |                    | a Mutt's
tzafrir at cohens.org.il |                    |  best
tzafrir at debian.org    |                    | friend