すいません、VB4しかやってないんです、VBAはやったけど(ぼそ) チラシの裏だって立派な書き込み空間なんだからねっ!資源の有効活用なんだからねっ!とか偉そうに言ってるけど、実は色々と書き残したいだけ

だからなに? どうしろと? くるみサイズの脳みそしかないあやしいジャンガリアンベムスターがさすらう贖罪蹂躙(ゴシックペナルティ)

ホーム 連絡をする 同期する ( RSS 2.0 ) Login
投稿数  632  : 記事  35  : コメント  11659  : トラックバック  143

ニュース


片桐 継 は
こんなやつ

かたぎり つぐ ってよむの

大阪生まれ河内育ちなんだけど
関東に住みついちゃったの
和装着付師だったりするの
エセモノカキやってたりするの
VBが得意だったりするの
SQL文が大好きだったりするの
囲碁修行中だったりするの
ボトゲ好きだったりするの
F#かわいいよF#

正体は会った人だけ知ってるの

空気読まなくてごめんなさいなの


わんくまリンク

C#, VB.NET 掲示板
C# VB.NET掲示板

わんくま同盟
わんくま同盟Blog


WindowsでGo言語
WindowsでGo言語


ネット活動


SNSは疲れました

記事カテゴリ

書庫

日記カテゴリ

ギャラリ

イベント活動

プログラムの活動

さて、ただいま病人は戦力外です<おい といっても職場は暇どころか戦場真っ只中なわけで……、なので、このタイミングで開発ドキュメントを整備してしまおうなんて事を考えたところ、ふと、気がつきました。もはや凄まじい数のクラスメソッドプロパティ、こんなのWordやExcelになんてやってらんない。そこでMSDNみたくHelpファイルにしちまえ、てなわけで砂の城プロジェクトが始動したわけです。

SandCalstleセットアップ

まずは、SandCastle をダウンロードします。msiファイルで配布されているのでサクっとインストールしてしまいましょう。次にHelpファイル作成のためのキットもセットします。 こちらのページの下の方に「日本語版Zipファイル」があるのでこれをダウンロードして解凍します。パスはそのまま変更せずにただの「Unzip」で大丈夫ですよん。

SandCasle
http://www.microsoft.com/downloads/details.aspx?FamilyId=E82EA71D-DA89-42EE-A715-696E3A4873B2&displaylang=en

HelpKit
http://msdn2.microsoft.com/en-us/library/ms669985.aspx

まぁ後はCUIでさくーっとやっちゃえば良いんですが、世間じゃGUIが主流らしいんです。で、GUIなツールをさらに……って事でSandCastle Help File Builder も入れちゃいます。

SandCastle Help File Builder
http://www.codeplex.com/SHFB

HELPファイル作成準備開始

後は、HELPファイルに記述する中身の整備。実はこれが一番大変だったりする。今からのプロジェクトで使う場合にこれを使うなら、はじめからコーディング規約とかにしとくと良いかも。みんなが幸せになれるから。とりあえず、ソースファイルにシングルコーテーションを3つ入れると、こんな風になるんで

    ''' <summary>
    ''' ここがタイトル、簡潔かつ美しくビシッと決めるw
    ''' </summary>
    ''' <param name="hoge">パラメータの説明も入れとくとGood</param>
    ''' <remarks>オブジェクトの説明とか書くとかっこいい</remarks>

以下、コメントをちまちまと入れておく。C#だと「///」ですかね。クラスやメソッドやプロパティや関数、それもPublicだのProtectedだのだのだのだの……きーっ!となりたいけど我慢して、がんばれ、後が楽になる&かっこええ!と浸れるからっって自分を信じてっ(笑)。 ちなみに、こんなタグなんかが使えるみたいです。他にも、<TABLE>タグが使えるのも確認済。ハッシュテーブルのキーValue一覧とかに使えるんじゃないかと(つか、使ったんだけどね)

タグ 説明
<summary> 概要
<remarks> 解説
<param> メソッドの引数
<returns> メソッドの戻り値
<value> プロパティ
<see> クラスやメンバへのリンク
<example> サンプル・コード
<seealso> クラスやメンバへの参照

このあたりのタグをできるだけ使って書いておくと素敵♪

できたらプロジェクトのプロパティにあるコンパイルタグの「xmlドキュメント生成」へチェックをして、いざリビルド!

 Complie
完成した、exe(dll)と一緒のフォルダにxmlがあることが確認できれば準備完了です。ちなみに、このXMLファイルに後からごにょごにょと追記してもっともっとときめき!なコンテンツにすることも可能。

SandCastle Help File Builder 起動

まずは、新規プロジェクトを作成。ADDボタンを押下して作成したいexe,dllファイルを指定すると、同パス同名のXMLファイルも同時に取得して設定してくれます。

HelpBuilderMain

で、プロパティに色々とセット。
言語は日本語が選べるので、こちらを選択しておくこと。
ヘルプファイルのOUTPUTパスも指定。こうしておかないとどこに出来たかわかんなくなる。

Porpertys

設定したら、ビルド開始。延々延々とビルド終了を待ちます。
ビルド終了したら、OUTPUTパスにCHMファイルがあるのを確認。

かっけーっ!すっごいすっごいヘルプファイルの完成!!

pic

出来上がったヘルプファイルはいじるにいじって、悦に浸れます。いやまぢで。

投稿日時 : 2007年9月12日 0:07

コメント

# re: ドキュメントの加工方法 2007/09/12 0:51 やまだの仮想庭園
re: ドキュメントの加工方法

# re: SandCastle Help File Builder を使ってみる 2007/09/14 9:51 シャノン
砂城ってオープンソースじゃねぇんでしたっけ?

# 侮れないゾ、SandCastleのAdditionalContent 2007/10/03 20:43 すいません、VB4しかやってないんです、VBAはやったけど(ぼそ)
侮れないゾ、SandCastleのAdditionalContent

# re: SandCastle Help File Builder を使ってみる 2008/05/22 12:12 Snew
http://www.hotdocument.net/
を使っています。
有償の分、やはりドキュメントとしては良いと思っています。


# HaMvFkAIUvua 2011/12/13 17:31 http://www.birthcontrolremedy.com/birth-control/ya
Yet, much is unclear. Could you describe in more details!...

# JEoZDhxbZclfu 2011/12/22 21:39 http://www.discreetpharmacist.com/
DX0yik Last a few years has been to Ibiza, so met a person there whose style of presentation is very similar to yours. But, unfortunately, that person is too far from the Internet!...

# Oakley Outlet 2013/03/23 20:17 http://oakleyfrogskinssunglasses4u.devhub.com
Linda speaks as if she were a boss.Excuse me,Sir.Have fun!The salve will heal slight burns.Time is running out.He suddenly appeared in the party.He suddenly appeared in the party.Bottoms up!Do me a favor? He was married to a friend of mine

# como comprar generico en espa&amp;#241;a 2018/01/07 9:08 FARMACIA ONLINE
Donde comprar generico contrareembolso en España http://farmacia-en-linea.life/apo-napro-na.html como comprar en farmacia en España.

# Buying in singapore 2018/01/08 5:59 how much does cost in south africa
online order uk http://www.fmsl.net/?option=com_k2&view=itemlist&task=user&id=55636 can i get without insurance.

# New zealand prescription 2018/01/08 6:52 Where can I get now
can you buy online in canada http://expert-dom.ru/?option=com_k2&view=itemlist&task=user&id=184857:wadearnot3530443 er prices without insurance.

# Cheap generic online 2018/01/08 14:09 pill price
can you buy online canada http://treeandpixie.com.au/index.php/component/k2/itemlist/user/75067 uk price.

# Can I get in australia 2018/01/08 17:45 usa shipping
order online overnight delivery http://tsf-team.com/user/KermitMccreary/ purchase uk.

# Cheapest price canada 2018/01/08 23:28 Without a doctor prescription usa
generic uk next day delivery https://information.za.org/profile.php?a=6033 Buy online cheap uk.

# Online canada generic 2018/01/09 4:49 purchasing online for cheap
low price http://ocispain.com/index.php/component/k2/itemlist/user/1303579 where to buy in philippines.

# Comparaison prix 2018/01/09 23:47 MEDICAMENTS ONLINE
Acheter generique en france http://medicamentsonline.life/coveram.html sans ordonnance en italie.

# kun je kopen online 2018/01/10 6:59 online medicijnen bestellen life
Apotheek belgie duitsland, http://online-medicijnen-bestellen.life/depakote.html , nederland rotterdam.

# uten resept tabletter 2018/01/11 22:27 Forste Apotek Norge
apotek Norge Oslo, http://forste-apotek-norge.life/phenergan.html , Hvordan kjøpe.

# billiga alternativ till 2018/01/12 1:54 APOTEKVARER PA NETTET
apoteket receptfritt pris, http://apotekvarerpanettet.life/actonel.html , köpa i USA Sverige.

# tabletter k&amp;#246;pa online 2018/01/12 7:26 apotekvarer-pa-nettet.life
apoteket receptfritt köpa, http://apotekvarerpanettet.life/femara.html , og p piller.

# verkopen holland 2018/01/12 9:51 onlineapothekerzonderrecept life
Frankrijk prijs, http://onlineapothekerzonderrecept.life/valtrex.html , prijs belgie frankrijk.

# till salu g&amp;#246;teborg 2018/01/12 13:50 billige apotekvarer life
receptfri, http://apotekvarerpanettet.life/diflucan.html , kostar göteborg.

# goedkoop online rotterdam 2018/01/12 15:19 online apotheker zonder recept
Kopen in frankrijk belgie, http://online-apotheker-zonder-recept.life/avodart.html , prijs apotheek belgie kopen.

# beste sted &amp;#229; kj&amp;#248;pe kj&amp;#248;p 2018/01/12 15:41 apotek-nettbutikk-norge.life
tabletter København, http://apotek-nettbutikk-norge.life/periactin.html , prissammenligning netto.

# s&amp;#228;ljes tabletter 2018/01/12 21:02 billige apotekvarer life
alternativ till generic, http://apotekvarerpanettet.life/carbozyne.html , kostnad recept.

# goedkoopste kopen 2018/01/12 21:23 Apotheker Nederland Online
Bestellen belgie kopen, http://onlineapothekernederland.life/januvia.html , kopen zonder recept nederland online.

# pris Norge 2018/01/13 7:13 APOTEK NORWAY
uten resept i Norge netthandel, http://apoteknorway.life/bystolic.html , pris resepte.

# olcs&amp;#243; elad&amp;#243; 2018/01/13 8:46 Gyogyszertar Hungaria
vásárlás azonnal recept, http://online-gyogyszertar.life/paroxetine.html - olcsó tabletta ára.

# k&amp;#246;pa online lagligt 2018/01/13 9:51 Apotekvarer Pa Nettet
lagligt, http://apotekvarerpanettet.life/precose.html , säkert göteborg.

# waar kopen in belgie nederland 2018/01/13 10:00 Apotheek Online
Bestellen zonder recept te koop, http://onlineapotheekzonderrecept.life/betnovate.html , prijsvergelijking rotterdam.

# v&amp;#225;s&amp;#225;rl&amp;#225;s azonnal online 2018/01/13 14:14 Gyogyszertar Hungaria Online
rendelése, http://gyogyszertar-online.life/micronase.html - eladás.

# piller pris 2018/01/14 0:54 apotek norge online life
kjøpe, http://apoteknorgeonline.life/retin-a.html , Hvor kjøpe kjøp.

# elad&amp;#243; rendel&amp;#233;se 2018/01/14 6:09 Gyogyszertarban Hungaria
árösszehasonlító eladó, http://gyogyszertarban-online.life/imuran.html - természetes tabletta.

# apoteket g&amp;#246;teborg 2018/01/14 6:18 Apotek Sverige
billiga göteborg, http://apotekvarerpanettet.life/pyridium.html , köpa Sverige Stockholm.

# beste sted &amp;#229; kj&amp;#248;pe pris 2018/01/14 9:33 internet apotek norge
til salgs København, http://internetapoteknorge.life/erythromycin.html , reseptfri jeg.

# receptfria tabletter 2018/01/14 14:11 Apotek Pa Natet
alternativ, http://apotekvarerpanettet.life/tricor.html , köpa göteborg.

# Tablets price in uk 2018/01/14 19:23 generic online overnight shipping
lowest price http://www.andersfray.com/blog/?page_name=suhagra buy generic.

# generisk Danmark 2018/01/15 0:03 norge apotek life
Oslo pris, http://norgeapotek.life/citalopram.html , kjøp av beste.

# Buying pills australian 2018/01/16 5:42 pills for sale
canada drug http://www.noraleduc.com/?page_name=robaxin buy online cheap canada.

# pastillas precio en argentina 2018/01/22 5:56 GWSISECURITY
Se vende con receta http://www.gwsisecurity.com/fig/data/farmacia/scherisolona.html comprar por internet en Mexico.

# tabletas mexico 2018/01/22 12:08 HANDLE DESIGNS
Como conseguir en costa rica http://handledesigns.com/img/farmacia/flogaren.html comprare.

# Consta preise 2018/01/22 14:27 VEDIC
preis apotheke osterreich http://www.vedicastrologyservices.com/_fpclass/apotheke/vaniqa.html generikum ohne rezept.

# Generika &amp;#246;sterreich 2018/01/22 14:27 BLAKE
co generika http://blakemarymor.com/DROPBOX/apotheke/ponstel.html pille bestellen ohne rezept.

# venta de en lima 2018/01/22 18:15 highdesertpintohorse
Sin receta medica en lima http://highdesertpintohorse.org/machform/data/form_10940/farmacia/dexamin.html cuanto cuesta en Uruguay.

# comprar por internet en peru 2018/01/22 18:15 Mdaane
Precio farmacia andorra http://mdaane.com/images/blogImages/farmacia/flotral.html hace falta receta para comprar en Andorra.

# comprar en farmacias espa&amp;#241;olas 2018/01/23 0:11 harrison1966.com
Comprar generico en barcelona http://www.harrison1966.com/gallery/farmacia/lanzor.html venta Ecuador.

# puedo comprar en usa 2018/01/23 0:11 CYPRESS ASSISTANCE
Comprar online seguro http://www.cypressassistance.org/wp-content/uploads/2017/04/farmacia/sumamed.html generico en farmacias sin receta.

# Telefonisch bestellen 2018/01/23 3:12 Chrono valve
migrane preis http://chronovalve.com/ezg_data/apotheke/desmin.html preisvergleich deutschland.

# quiero comprar en buenos aires 2018/01/23 5:36 ibi-tn.com
Donde comprar sin receta en venezuela http://www.ibi-tn.com/restricted/ibishare/farmacia/crotamitex.html comprar en España farmacia.

# se puede comprar sin receta en venezuela 2018/01/23 5:36 darkagemedia.com
Comprar pastillas en España http://darkagemedia.com/DDD/farmacia/supracam.html cuanto cuestan las pastillas en Colombia.

# Mini kautabletten beipackzettel 2018/01/23 6:40 skaneateles club
in deutschland online kaufen http://skansailclub.com/sites/default/files/color/apotheke/doxyclin.html tabletten bei horsturz.

# Tabletten schweiz 2018/01/23 12:33 danazheng
online bestellen nachnahme http://danazheng.com/assets/fonts/apotheke/azelastine.html rezeptfreie apotheke.

# Haarausfall tabletten 2018/01/23 14:04 SNAP APPLE
generika per uberweisung kaufen http://snapapplephoto.com/oldsite/images/apotheke/alfunar.html preise schwarzmarkt.

# necesito comprar en espa&amp;#241;a 2018/01/23 14:27 ALEJANDRO
Como consigo en España http://alejandromarmol.com/blog/farmacia/pyridium.html como conseguir rapido.

# donde comprar en monterrey 2018/01/23 15:47 straus
Venta de por internet http://www.jessica-straus.com/system/expressionengine/cache/farmacia/bectam.html conseguir sin receta Madrid.

# donde puedo conseguir en torreon 2018/01/23 20:39 WWW.METALNEX.COM
Online paypal http://www.metalnex.com/wp/design/farmacia/loitin.html necesita receta medica en Mexico.

# Kosten consta 2018/01/23 22:04 GOLF SCORECARD
Apotheke online http://golfscorecard.net/slideshowpro/apotheke/prinivil.html Deutschland bestellen.

# cuanto cuestan las pastillas en venezuela 2018/01/24 2:47 banglaunited.com
Donde comprar online seguro http://www.banglaunited.com/farmacia/danatrol.html como conseguir sin receta medica en Argentina.

# Medikamente &amp;#246;sterreich 2018/01/24 7:37 tepoztlan rentals
Tabletten anwendungsgebiete http://tepoztlanvacationrentals.com/llcj/cache/apotheke/vasonit.html generika ohne rezept deutschland.

# Kostenlos kaufen 2018/01/24 11:10 GOCROSSROADS
online apotheke ohne rezept http://www.gocrossroads.net/oldsite/cgi-bin/bk/active_guestbook_backups/apotheke/fluticasonpropionat.html filmtabletten packungsbeilage.

# Where can I buy online 2018/02/14 18:21 generic pharmacies review
Buy generic online overnight http://genericpharmacies.review/ canada price.

# Purchasing in new zealand 2018/02/14 18:44 medications-online
how much does cost in south africa http://medications-online.men can you buy over the counter uk.

# Pills online purchase 2018/02/15 14:11 medications online
where can i get uk http://medicationsonline.men/ price of generic.

# uk background check missouri gun show 2018/03/26 20:05 arrest lookup
Yuma county colorado arrest records, http://arrest-lookup.science/los-angeles-county-arrest-records-public-records.html how do i find arrest records in florida.

# what is involved in a background check security number 2018/03/27 0:45 background checking
Public arrest records riverside ca, http://background-checking.science/quinnipiac-poll-background-checks.html public criminal record search canada.

# credit and background check information needed 2018/03/27 5:34 affordable-background-checks.science
Background check lexisnexis, http://affordable-background-checks.science/how-to-get-a-police-background-check-it-take.html finding divorce records online.

# status of background check questionnaire sample 2018/03/27 7:19 background check yourself
Fingerprint for background check, http://background-check-yourself.science/name-history-search-voter-id-card-no-delhi.html public records kandiyohi county minnesota.

# background of job websites 2018/03/27 14:32 advanced background checks science
Sealing criminal records idaho, http://advanced-background-checks.science/lease-background-check-votes-against.html sarasota county arrest record search.

# what kind of background checks do companies run 2018/03/28 1:42 background-check-usa.science
Maryland public records for real estate, http://background-check-usa.science/insurance-background-check-free-trial-no-credit-card.html free inmate search by name.

# order a background check on yourself need to do you 2018/03/28 2:00 check background
Break ins in my area, http://advanced-background-check.science/info-about-person-liars-season-4-episode-13-watch-online-novamov.html ohio judicial public records.

# google background search free 2018/03/28 12:12 background checks
Pre employment screening importance, http://advance-background-checks.science/how-to-start-a-background-check-business-run-your.html washington county oklahoma district court records.

# background check information form nh state 2018/03/28 18:18 background-check-tenants
San antonio texas public records search, http://background-check-tenants.science/what-does-companies-check-for-in-a-background-check-involve-credit.html washington dc superior court records.

# what consist of a background check show employment 2018/03/28 23:36 advance background check science
How long does it take to get a background check and drug test back, http://advance-background-check.science/search-for-missing-person-by-social-security-number.html state of tennessee public arrest records.

# background check authorization usa free criminal 2018/03/28 23:52 background-check-tenant.science
Mclean county illinois public records, http://background-check-tenant.science/background-check-investigator-employment-verify.html warren county nj police records.

# complete background screening sterling 2018/03/29 8:47 screening background accurate
Pasco county florida arrest records search, http://accurate-background-screening.science/what-companies-do-background-checks-years.html free dui arrest records california.

# background check database canada immigration 2018/03/29 17:58 check background
Jena louisiana public records, http://accurate-background-checks.science/free-criminal-records-free-to-public.html oklahoma public records office.

# arrest warrant search jacksonville fl 2018/03/29 23:46 check background
Criminal records search ohio free, http://accurate-background-check.science/business-background-check-california-law-7-year-rule.html cook county inmate search.

# totally free public arrest records 2018/03/30 5:22 access background checks
Free background check really free, http://access-background-checks.science/gov-public-record-illinois-marriage-license.html free criminal public records florida.

# background check on myself buy a gun in florida requirements 2018/03/30 11:31 background check sites
Background checks phoenix arizona, http://background-check-sites.science/criminal-background-check-illinois-california-employees.html illinois circuit court public records search.

# clear background check employment how long does it take for a pre 2018/04/02 15:35 http://access-background-checks.stream
Criminal records oklahoma city ok, http://access-background-checks.stream/marriage-records-idaho-search.html - access-background-checks.stream cherokee county georgia clerk of court public records.

# Illikebuisse glwvd 2021/07/04 15:09 pharmacepticacom
hydroxycloquin https://www.pharmaceptica.com/

# earch our drug database. Generic Name.
https://edonlinefast.com
Cautions. Get information now. 2023/02/16 21:53 EdPills
earch our drug database. Generic Name.
https://edonlinefast.com
Cautions. Get information now.

# Learn about the side effects, dosages, and interactions. Comprehensive side effect and adverse reaction information.
https://canadianfast.com/
All trends of medicament. Read information now. 2023/02/20 5:18 CanadaBest
Learn about the side effects, dosages, and interactions. Comprehensive side effect and adverse reaction information.
https://canadianfast.com/
All trends of medicament. Read information now.

# price of doxycycline - https://doxycyclinesale.pro/# 2023/04/22 4:01 Doxycycline
price of doxycycline - https://doxycyclinesale.pro/#

# order cytotec online - https://cytotecsale.pro/# 2023/04/29 4:38 Cytotec
order cytotec online - https://cytotecsale.pro/#

# ed medications list: https://edpills.pro/# 2023/05/16 3:16 EdPillsPro
ed medications list: https://edpills.pro/#

# paxlovid generic https://paxlovid.pro/# - buy paxlovid online 2023/07/03 3:55 Paxlovid
paxlovid generic https://paxlovid.pro/# - buy paxlovid online

# natural remedies for ed https://edpillsotc.store/# - best treatment for ed 2023/10/08 1:07 EdPills
natural remedies for ed https://edpillsotc.store/# - best treatment for ed

# farmacia online migliore https://farmaciait.pro/ farmacia online 2023/12/04 10:11 Farmacia
farmacia online migliore https://farmaciait.pro/ farmacia online

# non prescription ed pills https://edpills.tech/# best ed treatment 2023/12/23 8:09 EdPills
non prescription ed pills https://edpills.tech/# best ed treatment

Post Feedback

タイトル
名前
Url:
コメント