مشاكل مع Sandcastle:الترجمة وغلاف اسم الملف

Question

أنا أستخدم Sandcastle Help File Builder لإنشاء وثائق لمشروع مفتوح المصدر، وأواجه مشكلتين:

• محتوى الوثائق باللغة الفرنسية.لقد قمت بضبط اللغة على الفرنسية في مشروع SHFB، ولكن معظم النص الذي تم إنشاؤه لا يزال باللغة الإنجليزية ("خصائص"، "التسلسل الهرمي للميراث"، "انظر أيضًا"...).رأيت أن هناك عددًا قليلاً من الملفات المترجمة في مجلدات SharedContent (والتي في الواقع ليست مترجمة بالكامل)، ولكنها تسمح فقط بترجمة بعض الأشياء، معظمها تفاصيل (التعليقات، وإخلاء المسؤولية، وبيان الخصوصية، وما إلى ذلك). كيف يمكنني ترجمة بقية النص؟ لاحظ أن لدي نسخة باللغة الإنجليزية من Visual Studio 2008؛يمكن أن تكون هذه القضية ؟

• يتم إنشاء الوثائق بتنسيق HTML وسيتم استضافتها على خادم Linux/Apache.لسوء الحظ، تحتوي العديد من أسماء الملفات التي تم إنشاؤها بواسطة Sandcastle على غلاف غير متناسق، لذا فهي لا تعمل على خادم Linux.على سبيل المثال، "Index.html" لا يعتبر المستند الافتراضي بواسطة Apache (يجب أن يكون "index.html")، ولم يتم العثور على ملفات CSS بسبب الغلاف الخاطئ...يمكنني إصلاح الغلاف يدويًا، ولكن يجب أن أفعل ذلك مرة أخرى في كل مرة أقوم فيها بإعادة بناء الوثائق. هل هناك حل معروف لهذه المشكلة؟ أعتقد أنني لست أول من قام باستضافة الوثائق التي تم إنشاؤها بواسطة Sandcastle على خادم Linux، ولكن لم أتمكن من العثور على أي معلومات مفيدة حول ذلك...

شكرا لمساعدتك

Answer 1

أعتقد أنني وجدت حلاً لمشكلة اللغة:

قم بتحديث لغة التوثيق التي أنشأتها Sandcastle

والآن كل ما علي فعله هو ترجمة جميع النصوص المرجعية ;)

فيما يتعلق بالمشكلة الثانية، يوجد في الواقع ملفان فقط بحاجة إلى إعادة تسميتهما (يجب إعادة تسمية ملفين Index.html وstyles/Presentation.css إلى أحرف صغيرة)، لذا فالأمر ليس سيئًا للغاية...

Answer 2

لا أعلم بخصوص السؤال الأول

وفي المسألة الثانية، واجهت شيئا مماثلا.لقد قمت ببناء أداة لتفريغ ملف .chm إلى ملفات مكونة، ثم تعديلها، وإضافة مقاطع دعائية، وما إلى ذلك.يمكنك القيام بشيء مماثل، وبدلاً من تحريرها، قم بإعادة تسميتها.

لتفريغ استخدمت الرمز من هذا المقال.

ولكن بعد ذلك اكتشفت أن SHFB يمكنه إنتاج ملفات .html مباشرة، لذلك قد تكون خطوة التفريغ هذه غير ضرورية.(لا أعرف، لم أرجع مطلقًا وقمت بتكوين SHFB لإنتاج ملفات html)

بمجرد قيامك بتفكيك ملفات HTML، أو إنتاجها مباشرةً من SHFB، يمكنك أيضًا إعادة تسمية المجموعة في برنامج نصي - مثل powershell أو javascript/cscript.exe.