샌드캐슬과 문제 : 나는 샌드캐슬 도움이 오픈 소스 프로젝트에 대한 문서를 구축 빌더 파일 사용하고

Question

현지화 및 파일 이름 케이스, 나는 두 가지 문제에 직면하고 있습니다 :

• 문서의 내용이 프랑스어입니다 . 나는 SHFB 프로젝트에서 프랑스어로 언어를 설정했지만, 생성 된 텍스트의 대부분은 여전히 ​​영어로되어 있습니다 ("Properties", "Inheritance Hierarchy", "See also also ..."). 나는 SharedContent 폴더 (실제로는 완전히 현지화되지 않은)에 몇 가지 현지화 된 파일이 있다는 것을 알았지 만, 대부분 세부 정보 (피드백, 면책 조항, 개인 정보 보호 정책 등) 만 번역 할 수 있습니다. 나머지 텍스트는 어떻게 현지화 할 수 있습니까? 영어 버전의 Visual Studio 2008이 있습니다. 그게 문제가 될 수 있니?

• 설명서는 HTML로 생성되며 Linux/Apache 서버에서 호스팅됩니다. 불행하게도 Sandcastle이 생성 한 많은 파일 이름은 대소 문자가 일치하지 않으므로 Linux 서버에서는 작동하지 않습니다. 예를 들어, "Index.html"은 Apache에서 기본 문서로 간주하지 않습니다 ("index.html"이어야 함). 잘못된 대소 문자로 인해 CSS 파일을 찾을 수 없습니다. 수동으로 대소 문자를 수정할 수도 있지만 문서를 다시 작성할 때마다 다시해야 할 것입니다. 그 문제에 대한 알려진 해결책이 있습니까? 나는 리눅스 서버에 샌드캐슬에 의해 생성 된 문서를 개최하는 최초의 하나가 아닌 것 같아,하지만 난 그것에 대해 유용한 정보를 찾을 수 없습니다 ... 당신의 도움을

감사를

Answer 1

나는 내가 언어 문제에 대한 해결책을 찾을 생각 :

Update the language of documentation created by Sandcastle

지금은 단지 모든 참조 텍스트를 번역해야 할 두 번째 문제에 관해서는)

을 실제로 단지 2가있다 (Index.html 및 styles/Presentation.css는 소문자로 이름을 바꿔야합니다.)

Answer 2

나는 첫 번째 질문에 대해 모른다.

두 번째 문제에서 나는 비슷한 것을 직면했습니다. .chm 파일을 구성 파일에 압축을 풀고 예고편을 추가하는 등의 작업을 수행 할 수있는 도구를 만들었습니다. 이러한 파일을 편집하고 이름을 바꾸는 대신 비슷한 작업을 수행 할 수있었습니다.

압축을 풀려면 this article 코드를 사용했습니다.

하지만 SHFB가 .html 파일을 직접 생성 할 수 있다는 것을 알았습니다. 따라서이 압축 풀기 단계가 불필요했을 수 있습니다. (나도 모르겠다. 나는 결코 돌아가서 HTML 파일을 생성하기 위해 SHFB를 구성하지 않았다.)

HTML 파일을 압축 해제했거나 SHFB에서 직접 생성 한 후에는 스크립트에서 이름을 바꿀 수있다. powershell 또는 javascript/cscript.exe를 사용하십시오.