Convertir sortie Sandcastle Aide Builder fichier (site Web) au format MediaWiki

Question

Je dois

1. convertir mon Sandcastle fichier d'aide Builder (SHFB) sortie qui est un site Web (HTML) au format wiki Media
2. Trouvez un moyen de transférer/d'inclure les pages directement dans le MediaWiki que nous avons configuré.

Des idées? Nous avons plus de 1000 pages de fichiers HTML sur le site Web (sortie de SHFB).

J'ai pensé à utiliser un convertisseur html2wiki .. Je pourrais penser à chercher un script pour convertir ces 1000 pages en format wiki ... qui pourrait prendre en charge (1).

Mais je serais encore avec le bloc dans le dernier bit du pipeline - comment nourrir les pages converties directement dans le Wiki?

Answer 1

J'ai travaillé sur l'ingestion de matériel existant de plusieurs sites dans un Wiki complet. Cela n'impliquait pas Sandcastle, mais si vous avez affaire à du HTML, cela ne devrait pas avoir beaucoup d'importance. html2wiki extensions sont là, et d'après ce que j'ai lu, ils peuvent résoudre beaucoup de problèmes. J'avais besoin d'un peu plus de contrôle sur chaque nœud du DOM, j'ai donc utilisé Simple HTML DOM Parser. C'est en PHP et a été facilement inclus dans les includes de Mediawiki.

Pour créer les nouvelles pages, j'ai fini par écrire un petit script qui utilise la classe Article de Mediawiki, plus précisément le doEdit function. Cela vous permet de créer de nouveaux articles par programmation, sans interaction de l'utilisateur. Bien sûr, vous devriez faire attention à cela ... La dernière chose dont vous avez besoin est de créer 1000 pages qui ne sont pas bonnes et doivent être supprimées. Mais peut-être que cela vous aidera à aller de l'avant.

Answer 2

Jetez un coup d'œil au serveur d'aide. Il permet de publier .CHM/.HxS produit par n'importe quel outil (y compris Sandcastle) sur le web et fournit URL-based integration API.

Nous utilisons aussi MediaWiki. A set of templates for it nous permet de créer des liens vers une référence de classe partagée par le serveur d'aide. Quelques exemples de tels liens peuvent être trouvés sur cette page.

Notez que le site Web DataObjects.Net Help fonctionne sur le serveur d'aide 2.X, mais le plus récent est 3.X (example web site is here).