Multilingual DDoc

[Brian Schott]

On Tuesday, 4 March 2014 at 08:21:27 UTC, Uranuz wrote:
> I'm novice in D documentation system. I haven't done any 
> comments in DDoc style but want to. My problem is that I want 
> to share my library with community but in the same time I need 
> to make it understandable for programmers in my team who speak 
> Russian but not so good in English. For now I don't want to 
> create documentation and then translate it because as I think 
> it will take a lot of time. But writing doc comments in 2 
> languages would be a good idea for now.
>
> So my question is how it's about multilingual comments in DDoc? 
> What I want is to be able to manage what language to use in doc 
> generation (may be by compiler switch) or put secondary 
> language under spoiler when rendering HTML format docs. Also 
> what is about integration with translation services like Google 
> Translate?
>
> Also I would be glad to get some info for getting started with 
> DDoc.

You can accomplish something similar to this by using DDoc's 
existing macro system.

/**
  * Some documentation in one language
  * $(TRANSLATION Some documentation in another language)
  * Macros:
  * TRANSLATION=<span class="translation">$0</span>
  */