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
Post a Comment