c# - How to localize the documentation of a .NET library -


i have open-source project (here) documentation in french. documentation generated xml comments in code, using sandcastle. translate documentation english , provide documentation in both languages, don't know start...

  • do need extract xml comments code , put them in separate file? if yes, there tools automate process?
  • i'm using sandcastle file builder build documentation; need create separate project build doc in english, or can done same project?
  • are there tools in translation process? e.g. display original , translated doc side side?

i'm interested in links on how produce multilingual documentation, couldn't find useful on google...

one strategy, require coordination sandcastle xslt files, use xml:lang attribute on xml documentation. visual studio 2010 allows multiple tags remain (although may complaints duplicate tags).

/// <summary> /// gets or sets fill size of load operation. /// </summary> /// <summary xml:lang="fr"> /// obtient ou définit la taille de remplissage de l'opération de chargement. /// </summary> public int fillsize {     get;     set; } 

resulting output:

<member name="p:namespace.myattribute.fillsize">     <summary>     gets or sets fill size of load operation.     </summary>     <summary xml:lang="fr">     obtient ou définit la taille de remplissage de l'opération de chargement.     </summary> </member> 

Comments