.Net XML komentar ke Dokumentasi API
Apakah ada cara mudah untuk menghasilkan MSDN-gaya dokumentasi dari Visual Studio XML output? I'm tidak cukup sabar untuk set up yang baik xslt untuk itu karena saya tahu saya'm bukan orang pertama yang menyeberangi jembatan ini.
Juga, saya mencoba menyiapkan sandcastle baru-baru ini, tapi itu benar-benar membuat mata saya cross. Baik aku kehilangan sesuatu yang penting dalam proses atau itu hanya terlalu terlibat.
Aku tahu ada seseorang di luar sana telah benar-benar mati-solusi sederhana.
I'm mengulangi di sini karena saya pikir saya format membuat paragraf non-mengundang untuk baca:
saya memberi sandcastle mencoba tapi memiliki waktu yang sangat sulit mendapatkan set up. Apa yang saya benar-benar ada dalam pikiran adalah sesuatu yang jauh lebih sederhana.
Artinya, kecuali jika aku hanya don't memahami sandcastle proses. Sepertinya banyak sekali tambahan bagasi untuk saya hanya untuk menghasilkan sesuatu yang baik bagi penguji untuk bekerja dengan.
Anda'kembali mencari Sandcastle
Halaman proyek: Sandcastle Rilis
Blog: Sandcastle Blog
NDoc Dokumentasi Kode Generator untuk .NET digunakan untuk menjadi alat pilihan, tapi dukungan semua tapi berhenti.
Silahkan lihat di Pasir, yang tidak tepat. It's juga salah satu yang lebih sederhana solusi di luar sana, dan itu's lebih atau kurang alat pilihan, sehingga dalam jangka panjang, mungkin kami bisa membantu anda untuk mengatur Sandcastle jika anda menentukan apa masalah yang anda hadapi selama setup?
Anda juga harus menggunakan Sandcastle File Bantuan Builder. Ini menyediakan anda dengan ndoc seperti GUI untuk menghasilkan file bantuan sehingga anda don't perlu melakukan apa-apa dari command prompt.
Selamat datang di the Sandcastle File Bantuan Builder Project
I've hanya mengatur Sandcastle lagi. Cobalah menginstal ini (Mei 2008 release) dan mencari SandcastleGui.exe atau sesuatu yang serupa (itu's dalam folder contoh atau lebih).
Klik Tambahkan Perakitan dan menambahkan Assembly atau Majelis, menambahkan .xml file Dokumentasi (orang-orang yang dihasilkan oleh compiler jika anda mengaktifkan opsi itu) dan kemudian Membangun.
Itu akan mengambil beberapa waktu, tapi hasilnya akan menjadi layak usaha. Itu benar-benar akan melihat hal-hal dari MSDN, sehingga dihasilkan dokumentasi juga akan memiliki Kelas Warisan semua jalan ke Sistem.Objek dengan link ke MSDN dan barang-barang.
Sandcastle tampaknya sedikit rumit pada awalnya, terutama jika anda ingin menggunakannya secara otomatis membangun, tapi saya benar-benar yakin itu akan menjadi layak usaha.
Lihat juga Sandcastle File Bantuan Builder, ini adalah agak lebih maju GUI untuk itu.
Ikuti ini 5 langkah sederhana artikel dan anda cukup banyak dilakukan. Sebagai bonus, anda dapat menggunakan H2Viewer untuk melihat Bantuan Html 2.x file.
Saya menggunakan NDoc3