XML 주석을 사용하여 응용 프로그램의 확장 성 API를 문서화 할 예정이지만 여러 언어를 사용하거나 이러한 파일을 지역화하는 방법에 대한 참조를 찾지 못했습니다. sandcastle이나 다른 도구 (ABD ...?)를 사용하고 싶습니다. 그러나 번역 된 XML 주석을 어디에 넣어야할지 모르겠습니다. 동일한 XML 스키마 등을 사용해야할지 모르겠습니다.Xml 주석 지역화
이 문제에 대해 어떤 경험이 있으십니까?
주석을 각 요소를 식별하는 xml : lang 속성과 함께 요소로 포함하는 XML 파일을 만듭니다 (스키마를 사용하고 있습니까?).
그런 다음 XSLT 또는 XQuery를 사용하여 필요에 따라 특정 언어로 버전을 만들거나 적어도 그렇게 할 수 있습니다.
위의 코드를 사용하면 실제로 은 대상 언어의 주석이있는 다른 파일을 생성 할 수 있습니다.
희망이 도움이됩니다.
Visual Studio 2010을 사용하여 편집기 확장 프로그램을 작성하는 것이 좋습니다. 새 편집기를 사용하면이 방법이 실제로 실용적으로 만들어지며 많은 예제가 게시됩니다.
그러나 다른 답변에서 설명한 것처럼 먼저 무엇을 달성해야하는지 파악해야합니다. 변경된 주석을 파일로 추출한 다음 다른 사람에게 변경 사항에 대한 현지화 프로세스를 시작하도록 알릴 필요가 있습니다. 아마도 자동 지역화를 수행하지는 않을 것입니다. 그러나 변경된 주석을 모아 번역 한 주석을 모아 번역 한 다음 번역 된 문서를 문서에 통합하는 과정을 자동화 할 수 있습니다.
좋습니다. 하지만 API의 원래 "XML 문서 파일"이 영어로되어 있다고 가정합니다. 파일을 복사하고 번역하면 빠르게 동기화되지 않습니다! – QbProg
그런 이유로 모든 번역본을 같은 장소에 보관하고 싶습니다. 하지만 파일을 유지 관리하는 모든 사람이 모든 언어를 알고 있거나 매우 규율이 있거나 특정 프로세스를 준수해야하는 경우가 아니면 동기화가 끊어짐에 따라 번역이 어려워 질 수 있습니다. – lavinio