使用定制 Eclipse 信息中心为 IT 解决方案编制文档,第 2 部分: 提升您捕捉和重用内容的能力
2010-03-11 00:00:00 来源:WEB开发网 闂傚倸鍊搁崐鎼佸磹閹间礁纾归柟闂寸绾惧綊鏌熼梻瀵割槮缁炬儳缍婇弻鐔兼⒒鐎靛壊妲紒鐐劤缂嶅﹪寮婚悢鍏尖拻閻庨潧澹婂Σ顔剧磼閻愵剙鍔ょ紓宥咃躬瀵鎮㈤崗灏栨嫽闁诲酣娼ф竟濠偽i鍓х<闁绘劦鍓欓崝銈囩磽瀹ュ拑韬€殿喖顭烽幃銏ゅ礂鐏忔牗瀚介梺璇查叄濞佳勭珶婵犲伣锝夘敊閸撗咃紲闂佺粯鍔﹂崜娆撳礉閵堝洨纾界€广儱鎷戦煬顒傗偓娈垮枛椤兘骞冮姀銈呯閻忓繑鐗楃€氫粙姊虹拠鏌ュ弰婵炰匠鍕彾濠电姴浼i敐澶樻晩闁告挆鍜冪床闂備胶绮崝锕傚礈濞嗘挸绀夐柕鍫濇川绾剧晫鈧箍鍎遍幏鎴︾叕椤掑倵鍋撳▓鍨灈妞ゎ厾鍏橀獮鍐閵堝懐顦ч柣蹇撶箲閻楁鈧矮绮欏铏规嫚閺屻儱寮板┑鐐板尃閸曨厾褰炬繝鐢靛Т娴硷綁鏁愭径妯绘櫓闂佸憡鎸嗛崪鍐簥闂傚倷鑳剁划顖炲礉閿曞倸绀堟繛鍡樻尭缁€澶愭煏閸繃宸濈痪鍓ф櫕閳ь剙绠嶉崕閬嶅箯閹达妇鍙曟い鎺戝€甸崑鎾斥枔閸喗鐏堝銈庡幘閸忔﹢鐛崘顔碱潊闁靛牆鎳愰ˇ褔鏌h箛鎾剁闁绘顨堥埀顒佺煯缁瑥顫忛搹瑙勫珰闁哄被鍎卞鏉库攽閻愭澘灏冮柛鏇ㄥ幘瑜扮偓绻濋悽闈浶㈠ù纭风秮閺佹劖寰勫Ο缁樻珦闂備礁鎲¢幐鍡涘椽閸愵亜绨ラ梻鍌氬€峰ù鍥敋閺嶎厼鍨傞幖娣妼缁€鍐煥濠靛棙顥滈柣锕備憾濮婂宕掑▎鎺戝帯濡炪們鍨归敃銈夊煝瀹ュ鍗抽柕蹇曞Х椤斿姊洪幖鐐插姶闁告挻鐟╅幃姗€骞庨懞銉у幐闂佸憡鍔戦崝搴㈡櫠閺囩姷纾奸柍褜鍓熷畷姗€鍩炴径鍝ョ泿闂傚⿴鍋勫ú銈吤归悜鍓垮洭鏁冮埀顒勬箒濠电姴锕ら悧蹇涙偩濞差亝鐓涢悘鐐额嚙婵″ジ鏌嶇憴鍕伌鐎规洖宕埢搴ょ疀閹惧妲楃紓鍌氬€搁崐鐑芥⒔瀹ュ绀夐幖杈剧到閸ㄦ繃銇勯弽顐粶濡楀懘姊洪崨濠冨闁搞劍澹嗙划濠氬箮閼恒儱鈧敻鏌ㄥ┑鍡欏嚬缂併劏妫勯湁闁绘ǹ宕甸悾鐑樻叏婵犲啯銇濇俊顐㈠暙閳藉鈻庨幇顓炩偓鐑芥⒑鐠囨彃顒㈤柣顓у櫍瀹曪繝骞庨懞銉ヤ粧濡炪倖娲嶉崑鎾垛偓瑙勬礀閻栧ジ銆佸Δ浣哥窞閻庯綆鍋呴悵顐⑩攽閻樻剚鍟忛柛锝庡灣瀵板﹪宕滆閸嬫挾绮☉妯绘悙缂佺姵鐓¢弻娑㈠Ψ椤旂厧顫╅梺钘夊暟閸犳牠寮婚敐澶婃闁圭ǹ瀛╅崰鎰版⒑閼姐倕鏋庣紓宥咃躬瀵鈽夐埗鈹惧亾閿曞倸绠f繝闈涙川娴滎亝淇婇悙顏勨偓銈夊礈濞嗘挻鍋嬮柛鈩冪▓閳ь剚妫冨畷姗€顢欓崲澹洤绠圭紒顔煎帨閸嬫捇鎳犻鈧崵顒傜磽閸屾艾鈧娆㈤敓鐘茬獥婵°倕鎳庣粻浼存煙闂傚鍔嶉柛瀣ф櫊閺岋綁骞嬮敐鍡╂缂佺虎鍘搁崑鎾绘⒒娴h櫣甯涢柛鏃€娲滅划鏃堟濞磋櫕鐩畷姗€顢欓崗鍏夹氶梻渚€鈧偛鑻晶顖炴煏閸パ冾伃妤犵偞甯¢獮瀣攽閹邦亞纾婚梺璇叉唉椤骞愭搴g焼濞撴埃鍋撻柛鈺冨仱楠炲鏁傞挊澶夋睏闂備礁婀辩划顖滄暜閳哄倸顕遍柍褜鍓涚槐鎾存媴閻熸澘濮㈤悷婊勫閸嬬喖宕氶幒鎴旀瀻闁规儳鐤囬幗鏇炩攽閻愭潙鐏﹂柣顓у枛閳讳粙顢旈崼鐔哄幍闁荤喐鐟ョ€氼剚鎱ㄩ崶銊d簻闁靛濡囩粻鐐存叏婵犲啯銇濋柡灞芥嚇閹瑩鎳犵捄渚純濠电姭鎷冮崒姘ギ闂佸搫鐬奸崰鏍箹瑜版帩鏁冮柨婵嗘噽閿涙捇姊绘担鐟邦嚋缂佽瀚板畷鎴濃槈閵忕姷鍘撮梺鐟邦嚟婵參宕戦幘缁樻櫜閹煎瓨锚娴滅偓銇勯幘瀵糕姇婵炲懎锕弻锛勪沪閻e睗锝嗙箾绾板彉閭鐐茬箳娴狅箓鎸婃径濠呭帿闂傚倸鍊烽悞锕傛儑瑜版帒纾归柡鍥ュ灩缁犵娀鏌熼柇锕€鏋熸い顐f礋閺岀喖骞嗚閹界姴鈹戦娑欏唉闁哄本鐩獮姗€寮堕幋鐘点偡闂備礁鎲¢幐绋跨暦椤掑嫧鈧棃宕橀鍢壯囨煕閳╁喚娈樺ù鐘虫倐濮婃椽鎳¢妶鍛瘣闂佸搫鎳忛惄顖炲箖妤e啯鍊婚柦妯猴級閵娧勫枑濠㈣埖鍔曠壕濠氭煙閸撗呭笡闁哄懏鐓¢獮鏍垝閻熸澘鈷夐梺璇茬箰缁夌懓顫忛搹鍦<婵☆垵顕ч棄宥呪攽閻愭彃绾ч柨鏇樺灪娣囧﹪鎮界粙璺槹濡炪倖鐗楀銊╂偪閳ь剟姊婚崒姘偓鎼佹偋婵犲嫮鐭欓柟閭﹀枦婵娊鏌ゅù瀣珖缁炬崘妫勯湁闁挎繂鐗婇ˉ澶愭煟閹炬潙濮堥柟渚垮妼铻g紒瀣仢椤鈹戦垾鍐茬骇闁告梹鐟╅悰顔嘉熼崗鐓庣彴闂佽偐鈷堥崜锕€危娴煎瓨鈷掑ù锝嚽归弳閬嶆煙绾板崬浜扮€规洘鍔栫换婵喰掔粙鎸庡枠鐎殿喛鍩栭幆鏃堝箻鐎涙ɑ婢戝┑锛勫亼閸婃牕顫忔繝姘ラ悗锝庝憾閸熷懘鏌曟径娑滅濞存粍绮嶉妵鍕箻鐠鸿桨绮跺┑鈩冨絻椤兘寮婚敐澶嬫櫜闁搞儜鍐ㄧ婵°倗濮烽崑鐐垫暜閿熺姷宓侀悗锝庡枛缁秹鏌嶈閸撶喖骞冨Δ浣虹瘈婵﹩鍘搁幏娲煟閻斿摜鎳冮悗姘煎弮瀹曟洖螖閸涱喚鍘卞┑鈽嗗灥閵嗏偓闁稿鎹囬幃銏ゅ箵閹烘垹闃€婵犵數濮烽弫鍛婃叏閻戣棄鏋侀柛娑橈攻閸欏繘鏌i幋锝嗩棄闁哄绶氶弻娑樷槈濮楀牊鏁鹃梺鍛婄懃缁绘垿濡甸崟顖氱闁告鍋熸禒鑲╃磼閻愵剙鍔ゆい顓犲厴瀵鎮㈤悡搴n槶閻熸粌绻掗弫顔尖槈閵忥紕鍘撻梻浣哥仢椤戝懘鎮橀敃鍌涚厪闁搞儜鍐句純濡ょ姷鍋炵敮鈥崇暦閸楃儐娓婚柟顖嗗本顥$紓鍌氬€搁崐鎼佸磹妞嬪海鐭嗗〒姘e亾閽樻繈姊洪鈧粔鎾几娴g硶鏀介柣妯挎珪閻ㄦ垹鈧鎸风欢姘跺蓟濞戙垹鐒洪柛鎰典簴婵洭姊虹粙鍖″姛闁稿繑锕㈠璇测槈濡攱鏂€闂佺硶鍓濋〃蹇斿閳ь剚淇婇悙顏勨偓鏍ь潖瑜版帒绀夐柡鍥ュ灩閻撴﹢鏌熸潏楣冩闁稿﹤顭烽弻娑㈠Ψ閵忊剝鐝栭柡宥忕節濮婄粯鎷呴崨濠傛殘闂佸湱枪椤兘骞冮悜鑺ユ櫆闁伙絽澶囬弨铏節閻㈤潧孝婵炶绠撳畷鐢稿礃椤旂晫鍘撻梺鍛婄箓鐎氼剟寮抽悢鍏肩叆婵炴垶鐟ч惌鎺撴叏婵犲洨绱伴柕鍥ㄥ姍楠炴帡骞嬪⿰鍐╃€抽梻鍌欑閹诧繝鎮烽妷锔绘闁归棿绀侀悡婵嬫煙閻愵剚鐏遍柛顐邯閺屾盯顢曢妶鍛亖闂佸憡蓱閹倿寮婚敐鍫㈢杸闁哄洨鍋橀幋椋庣磼缂併垹骞栭柣鏍帶閻g兘骞嬮敃鈧粻濠氭偣閸ヮ亜鐨洪柣銈傚亾婵犵數鍋犻幓顏嗗緤娴犲绠熼柨鐔哄Т绾捐銇勯弽顐沪闁抽攱鍨归惀顏堫敇閻愭潙娅f繛瀛樼矊缂嶅﹪骞冪捄琛℃闁哄诞鍐ㄐ曢梻浣虹《閺備線宕戦幘鎰佹富闁靛牆妫楃粭鎺楁煕閻曚礁浜伴柟顖氬暙鐓ゆい蹇撴噽閸樺憡绻涙潏鍓у埌婵犫偓鏉堛劍娅犳い蹇撶墛閻撳啴鎮峰▎蹇擃仼闁诲繑鎸抽弻鐔碱敊閻e本鍣伴悗娈垮枛閻栧ジ鐛€n喗鍋愰弶鍫厛閺佸洭姊婚崒姘偓椋庣矆娴i潻鑰块弶鍫涘妿娴犳岸姊绘担渚敯濠殿喓鍊楅崚鎺撴償閵娿儳顦梺鍦劋椤ㄥ懐鐚惧澶嬬厱妞ゆ劑鍊曢弸搴∶归悩鐑橆仩缂佽鲸鎸婚幏鍛村礈閹绘帒澹嶆俊鐐€栧ú妯荤箾婵犲洤鏋侀柛鎰靛枛绾惧吋绻涢幋鐐跺妤犵偛鐗撳缁樻媴閸涘﹥鍎撳┑鐐茬湴閸ㄨ棄鐣峰┑鍡欐殕闁告洦鍓欓埀顒€鐖奸弻锝呂熼懖鈺佺闂佺粯鎸诲ú鐔煎蓟閻斿吋鍤嬫い鎺嗗亾濠碉紕鍘ч湁婵犲﹤瀚崝銈夋煃鐟欏嫬鐏撮柡浣哥Ч瀹曠喖顢曢埄鍐╃窔闂傚倷鑳舵灙闁挎洏鍎甸幃褔鎮╅懠顒佹濠电娀娼ч鍡涘疾濠靛鐓冪憸婊堝礈閻旂厧鐏抽柨鏇炲€搁柨銈嗕繆閵堝倸浜鹃梺缁樺笒閻忔岸濡甸崟顖氱鐎广儱鐗嗛崢锛勭磽娴e搫孝濠⒀傜矙閸┾偓妞ゆ巻鍋撻柛妯荤矒瀹曟垿骞橀弬銉︽杸闂佺粯枪娴滎剛绮i弮鍫熺厱閻庯綆鍋掑▓鏃堟煃鐟欏嫬鐏存い銏$懅濞戠敻鎮滈悾灞藉冀濠电姷鏁搁崑娑㈠箯閹寸姴绶ら柛顭戝暎閿濆绠涢柡澶庢硶椤斿﹪姊洪悷鏉挎毐缁剧虎鍙冨畷浼村箻鐠囪尙顔嗛梺缁樶缚缁垶宕甸幋锔界厾缂佸娉曟禒娑欐叏閿濆棗濮嶆慨濠傤煼瀹曟帒顫濋钘変壕闁绘垼濮ら崵鍕煠閸濄儲鏆╁ù鐘崇缁绘繈鎮介棃娑楃捕濡炪倖娲﹂崣鍐ㄧ暦濡も偓铻e〒姘煎灠濞堛劌顪冮妶鍡楀闁稿﹥鐗滈埀顒佺濮樸劑鍩€椤掑倹鍤€濠㈢懓锕畷浼村冀瑜夐弸鏃堟煏婵犲繐顩紒鈾€鍋撻梻浣圭湽閸ㄨ棄岣胯閻楀海绱撴担鍝勪壕婵犮垺岣跨划鏃堟偡闁箑娈ㄩ梺鍝勮閸庤京绮婚悽鍛婄厵闁绘垶岣跨粻姗€鏌涢悙鍨毈闁哄矉缍侀幃鈺呮倻濮楀棔鍝楅梺璇茬箰缁诲牓宕濆畝鍕垫晩闊洦绋戝敮閻熸粌顦靛畷鎴﹀箻閼搁潧鏋傞梺鍛婃处閸撴瑧鍠婂鍛斀闁宠棄妫楁禍婵堢磼鐠囨彃鈧潡鏁愰悙鍓佺杸婵炴垶鐟﹂崕顏堟⒑闂堚晛鐦滈柛姗€绠栭弫宥呪堪閸愶絾鏂€闂佸疇妫勫Λ妤呮倶閻樼粯鐓欑痪鏉垮船娴滀即鏌ㄥ┑鍫濅粶妞ゆ挸銈稿畷鍫曞煛閸愯法闂繝鐢靛仩閹活亞绱炴笟鈧棢闁规崘顕х粈澶屸偓骞垮劚椤︿即鎮″▎鎴犵<閻庯綆浜炴禒銏ゆ煛閸℃稐鎲鹃柡宀嬬秮閺佹劙宕惰楠炲螖閻橀潧浠滄い鎴濐樀瀵偊宕橀鑲╁姦濡炪倖甯掗崐缁樼▔瀹ュ應鏀介柣妯虹-椤f煡鏌涚€e墎绉柡灞剧洴婵$兘骞嬪┑鍡樻婵°倗濮村ú顓㈠箖濡ゅ啯鍠嗛柛鏇ㄥ墮绾板秶绱撴担鍓叉Ч闁瑰憡濞婇崹楣冨籍閸繄顦ㄥ銈嗘煥濡插牐顦归柡灞剧洴閸╁嫰宕楅悪鈧禍顏勎涢崟顐悑闁搞儮鏅濋敍婵囩箾鏉堝墽鍒板鐟帮躬瀹曟洟骞囬悧鍫㈠幈闂侀潧枪閸庨亶銆傚畷鍥╃<妞ゆ梻鈷堥崕蹇斻亜閹惧啿鎮戠€垫澘瀚埀顒婄秵娴滄牠宕戦幘缁樼叆閻庯絻鍔嬬花濠氭⒑閻熺増鎯堢紒澶婄埣钘濋柨鏃堟暜閸嬫挸鈻撻崹顔界亪闂佽绻戠换鍫ュ春閻愬搫绠i柨鏇楀亾闁绘搫绻濋弻娑㈠焺閸愮偓鐣兼繛瀵稿閸ㄨ泛顫忓ú顏勫窛濠电姴娴烽崝鍫曟⒑閸涘﹥澶勯柛娆忛鐓ら柛娑橈梗缁诲棝鏌曢崼婵堢闁告帊鍗抽弻娑㈡偆娴e摜浠搁悗瑙勬礃閸旀瑥鐣疯ぐ鎺濇晝闁挎繂鎳庢导搴㈢節绾版ɑ顫婇柛銊﹀▕瀹曘垼顦崇紒鍌氱У閵堬綁宕橀埡浣插亾閸偅鍙忔俊顖滃帶娴滈箖鎮楀鐐

概述
在 使用定制 Eclipse 信息中心为 IT 解决方案编制文档,第 1 部分:创建您的第一个信息中心 中,您创建了自己的第一个解决方案信息中心,内含一个文件。在掌握了基础知识后,您就可以开始学习加速内容库内的文档的积累的技巧了,首先要做的是导入一个满载内容的示例解决方案信息项目。
从另外一个工具箱的用户导入内容
积累内容的第一种快捷途径是导入由其他用户创建的解决方案信息项目。若您的团队中有任何人捕捉到内容,那么团队中的所有人均可重用此内容。导入一个解决方案信息项目的好处是通过一个操作就可以向内容库添加各种类型的多个文档。内容在您的新的和已有的解决方案信息中心项目内均可重用。您还可以获得其他用户的解决方案导航视图,您可以重用或不使用这个视图。
要练习如何导入一个解决方案信息项目:
从本文的 下载 部分下载 TKCARSI-SAMPLE.zip 文件。
在工具箱内,从菜单栏选择 File > Import project。出现 Import Solution information project 对话框。
找到要下载的这个示例解决方案信息项目 TKCARSI-SAMPLE.zip。
返回到 Import Solution information project 对话框,单击 Finish。工具箱将会报告说它正在扫描这个项目。
当工具箱显示一个对话框,列出将被包含或覆盖的内容时,查阅这个列表,然后单击 OK。
查看进度条。通常,可以不理会所显示的任何错误消息。
如图 1 所示,在项目导入后,工具箱将会打开它的导航树。如果您不想现在就开始处理这个项目,也可以关闭这个导航树(File > Close project)。项目的内容已经添加到您的内容库以便在任何解决方案信息项目中都可使用。所导入的项目现在可以通过 File > Open project 获得。
图 1. 示例解决方案信息项目预览
查看原图(大图)
搜索并捕捉 IBM.com 内容
积累内容的第二种快捷途径是使用该工具箱的内置 IBM® Support Assistant,以从 IBM 站点大批量地搜索和捕捉内容。您可以捕捉 Web 页面的副本或到这些页面的链接。
要用来自 IBM.com 的内容填充工具箱内容库,可以执行下面的操作:
获取一组搜索结果。
在工具箱菜单栏中,单击 Search > Search the Internet。
当出现 Search Wizard 对话框时,在其中选择您的搜索目标。这个工具栏将要搜索的内容是 IBM Web 站点的一部分。在默认状态下,所有可能的目标都会选中。不过,选择的搜索目标越少,搜索速度就越快。因此,取消除 IBM developerWorks 之外的所有其他的搜索目标。
图 2. 搜索目标
在搜索框中,输入想要搜索的关键词。请注意 Advanced Search 选项,它可以让您细化对每个目标的搜索,例如将搜索限定在 IBM 产品的某个特定品牌。作为尝试,输入 “cloud computing” (不带引号)作为搜索关键词。
图 3. 搜索对话框
单击 Go! 按钮。工具箱会报告搜索结果,请留意查看。
选中您可能 想要保留在工具箱中的那些搜索结果。在后续的这个步骤中,将要正式地进行选择。
在 Search Results 区域,单击一个品牌的名字,例如 Information Management。
图 4. 搜索结果
浏览这些搜索结果,选择您想要为您的解决方案信息中心捕捉的那些文章。练习一下,单击 Select All 来获取前 10 个结果。
图 5. 搜索结果的选择
结束搜索结果的浏览和选择后,单击 Next。所选择的这些结果被显示在 Search Wizard 对话框的内容库页面的 Save 搜索结果中。
根据明确 希望保留的搜索结果,缩小选择范围。
在 Search Results Selected 区域中,选择确实想要保留的几个搜索结果。要想一次选中多个结果,请在单击每个结果时,同时按住 Control 键。
图 6. Search Results Selected 区域
根据需要,可以在 Search Results to Save 区域中选择想要在其中保存结果的那个内容组。内容组类似于用来分类存放可重用内容的小抽屉。
准备好后,单击 Add > 将选中的结果保存在所选中的这个内容组中。
图 7. Search Results to Save 区域
对于想要保存的结果,可以保存这些 Web 页的副本,也可保存指向 Web 页的链接。
使用 Search Results Selected 区域下的单选按钮。
要想保存指向这些页面的链接,单击 Create a link to the Web page。
要想保存副本,选择 Download the Web page content 并指定一个页面深度。例如:
深度 1 表示保存的页面包括页面的图片和样式信息。
深度 2 表示保存页面及其所链接的那层页面。
深度 3 表示保存页面、该页面链接到的那层页面以及该层页面链接到的那些页面。
最终完成搜索结果的捕捉。
单击 Finish。Retrieving Web Pages 对话框将会告知您进展的情况。
在捕捉结束后,查看内容库针对这些新页面的 Web Pages 选项卡页面。您现在可以将它们拖放进解决方案信息项目的导航树内了。
图 8. 搜索结果显示在内容库中
根据搜索目标,有时除 Web 页的标题和链接之外,工具箱还可以捕捉到一些细节。例如,如果单击编辑 Web 页面属性,就会注意到描述已被从 IBM developerWorks 文章中捕捉到,并且关键字字段反映了您的搜索关键词。
图 9. 搜索结果的细节已被填充
添加包含 IBM 产品文档的插件
积累可重用内容的第三个快捷途径是导入一个 Eclipse 编制文档插件。一个 Eclipse 文档插件是一个标准的打包格式,可用来显示 Eclipse 帮助系统(比如一个信息中心)中的内容。此插件的格式是一个文档文件,例如 ZIP 或 TAR 格式。在很多 IBM 产品库的页面都可以找到此插件,有时它也可能会与产品的帮助系统一同安装。要想找到这个文档插件,我们可以用命名模式 “com.ibm.*.doc*” 来寻找文件或目录,其中的 * 是通配符。
下面的步骤基于的是 IBM WebSphere Help System 插件:Virtual Enterprise(即之前的 Operations Optimization) 插件,该插件可以从 WebSphere Extended Deployment 库 下载得到。
将这个插件添加到内容库:
从一个 Web 站点下载一个文档插件并将这个插件的内容解压缩到文件系统。
浏览找到所下载的或是同产品一同安装的一个文档插件。
从菜单栏中选择 Window > Show View > Books。Books 的选项卡页面就会被显示到最前面。
单击 Add Books 按钮显示 New Books 向导。
在这个 New Books 向导中,单击名为 Directory: Browse 的单选按钮导向这个插件的根目录。
单击 Browse,导航到在文件系统上的那个插件。这稍微有些复杂:若 com.ibm 目录嵌套,那么请选择最内层的目录,如图 10 中所示。
图 10. 选择插件目录
当返回到 New Books 向导时,依据图 11 仔细核对设置,然后单击 OK。
图 11. New Books 向导设置
当出现 “Do you want to copy the content from the original directory into the toolkit?”(您是否想要将内容从原始目录复制到工具箱中?)的提问时,单击 Yes。
若出现一个对话框,提示您一些导航文件作为主导航文件的角色将被转变,单击 OK。这就是说,文档插件中的任何导航视图的级别都将低于解决方案信息项目的主导航视图。
将这些导航区段从插件中拖放进导航模板中。
查看您工具箱中的 Books 选项卡页面。
单击适当的内容组来查看这个插件中可用的导航文件。在本示例中,这个内容组名为 WebSphere® Virtual Enterprise Edition Version 6.1,并且这些导航文件也会有各自的名字,例如 prodovr.xml。
图 12. 添加到内容库的插件内容
将部分或全部导航文件拖放到这个导航模板的相关位置。
图 13. 包含在解决方案导航视图内的插件内容
查看原图(大图)
预览信息中心以便检查和调整这些结果。
图 14. 在信息中心内显示的插件内容
查看原图(大图)
显示在很多在线 IBM 信息中心的文档和一些基于 Eclipse 的开源项目的文档被打包成 Eclipse 文档插件的形式。若 IBM 产品库页面并没有提供所需插件的下载,那么您可以直接联系 IBM 寻求帮助。
自动地合并插件内容
最佳实践:Automatic Merge Links
如果您猜测 Automatic Merge Links 特性取决于在启动一个新的解决方案信息项目时的默认导航,那么您就猜对了。
添加新导航区段并不会影响日后合并内容的能力。
即便是重新布置了这些区段,合并仍能从其所在的新位置找到它们。
删除区段将使它们失去接收被合并内容的能力。
在保留其本义的情况下重命名一个区段不会有什么影响,例如将 “Troubleshooting” 更名为 “Problem determination”。
若重定义一个区段的目的,比如将 “Developing business applications” 重命名为 “Implementing SOA governance”,那么在日后进行内容合并时,很可能会生成奇怪的结果。相反,在需要的时候创建新的导航区段。
在向工具箱中添加了一个文档插件后,必须将它的内容拖入解决方案信息项目的导航内。若想只用一个工具条按钮就能让工具箱将插件的内容分散到解决方案导航中适当的位置,可否实现呢?这可以实现,只要启用插件的 Automatic Merge Links 特性即可。本文包括了一个 TKCARSI-TEMPLATE.zip 文件,可用来供您尝试 Automatic Merge Links 特性,此外还有一个能供插件作者启用他们自己的插件的说明和参考实现。
要尝试 Automatic Merge Links 特性:
获取 com.ibm.soln.TEMPLATE.enabled.doc_1.0.0 插件。
从本文的 下载 部分下载 TKCARSI-TEMPLATE.zip 文件。
解压缩这些内容,需要一个名为 com.ibm.soln.TEMPLATE.enabled.doc_1.0.0 的目录。
将这个文档插件添加到工具箱中。
在工具箱中,从菜单栏里选择 Window > Show View > Books。Books 选项卡页面将被显示到最前面。
单击 Add Books 按钮来显示 New Books 向导。
在 New Books 向导中,单击名为 Directory: Browse 的单选按钮导向插件的根目录。
单击 Browse,然后导航到文件系统上的 com.ibm.soln.TEMPLATE.enabled.doc_1.0.0 文件夹。
当返回到 New Books 向导时,单击 OK。
当出现 “Do you want to copy the content from the original directory into the toolkit?”(您是否想要将内容从原始目录复制到工具箱中?)的提问时,单击 Yes。
创建一个新的或打开一个现有的解决方案信息项目。建议您创建一个新的项目,如若已经删除或修改了解决方案信息项目默认导航中的某些区段,就更应如此。如果您正在预览一个解决方案信息项目,那么在此项目上执行 Automatic Merge Links 前,务必先将预览关掉。
单击 Automatic Merge Links 按钮。图 15 突出显示了它的位置。如果已经打开了一个解决方案信息项目导航树并且已经为 Automatic Merge Links 特性选中了一个 Book(文档插件),那么这个按钮应该是激活状态。否则,这个 Automatic Merge Links 按钮仍然会是灰色的。
图 15. Automatic Merge Links 按钮的位置
确认和观察合并操作。若出现提示,要求确认,单击 Yes。工具箱将报告有多少导航区段正在被插件内容填充。对 TKCARSI-TEMPLATE 插件来说,大约有 100 个导航区段收到了来自插件的一个或多个文档。要想查看结果,可以展开这个解决方案信息项目的导航树。
图 16. 合并到导航树的模板内容
预览这个信息中心来进一步研究这些结果,如图 17 所示。特别要注意一个导航区段是如何能从内容插件接收多个文档的。例如,有三个导航条目被添加到了 Demonstrate the template > Solution overview > Business context > Overview 区段。
图 17. 预览中的模板内容
启用插件的 Automatic Merge Links 特性
要启用文档插件的 Automatic Merge Links 特性,插件的作者需要向插件添加特殊的注释行。TKCARSI-TEMPLATE.zip 文件为插件作者提供了一个说明和一个参考实现。
可以查看 TKCARSI-TEMPLATE.zip 插件内的这些特殊的注释行。
如果向工具箱添加了这个插件,那么请导航到目录: tkcarsi1.5\bigeasy\workspace\content \com.ibm.soln.TEMPLATE.enabled.doc_1.0.0。否则,请导航到文件系统上插件内容被下载和解压缩到的那个目录。这个目录包括了为插件内可用的文档定义导航条目的 XML 文件。TKCARSI-TEMPLATE.zip 插件提供了一个 XML 文件,该文件对应于在启动一个新的解决方案信息项目时由工具箱显示出来的默认导航内的每个位置。
在一个文本编辑器中查看 Soln_Business_context_OVERVIEW.xml 文件。请注意以 <--Target= 开始的第二行。在每个 XML 文件中,都能发现一个类似的区分大小写的目标语句,这个语句指定了内容属于解决方案信息项目导航中的哪个位置。只要有注释出现,这个 XML 文件的名字就无关紧要。
清单 1. Soln_Business_context_OVERVIEW.xml 文件
<?xml version="1.0" encoding="utf-8"?>
<!-- Target=Soln_Business_context_OVERVIEW -->
<!--Arbortext, Inc., 1988-2005, v.4002-->
<?APT Element gi="toc" attrs="label topic link_to"?>
<?APT Element gi="topic" attrs="label href"?>
<?APT Element gi="anchor" empty="yes" attrs="id"?>
<?NLS TYPE="org.eclipse.help.toc"?><!--Nav fragment example-->
<toc label="This will not show" topic="This will not show">
<topic label="BUSINESS CONTEXT OVERVIEW" href="topics/Business context overview.html">
</topic>
<topic label="VALUE PROPOSITION" href="topics/Value-proposition.html">
</topic>
<topic label="WHO BENEFITS FROM THIS SOLUTION" href="topics/Who-benefits.html">
</topic>
</toc>
从 IBM Lotus Notes 数据库导入视图
第四个也是最后一个积累内容的快捷途径就是导入一组 Domino® XML 格式 (DXL) 的 IBM Lotus Notes® 文档。您可以从 Lotus Notes 数据库中的一个视图中导出一整套文件,例如邮件数据库中的一个特定文件夹。您可以导入一整套文件供在解决方案信息中心中重用。请注意这样一个限制,即工具箱只导入 Lotus Notes 文档的内容,并不导入它们的附件。
要将一组 Lotus Notes 文档导入到工具箱:
浏览找到一个内含被导出的 Lotus Notes 文档的本地 DXL 文件。
从菜单栏选择 Window > Show View > Notes。Notes 选项卡页面将被显示到最前面。
单击 Add Lotus Notes 内容图标(图标的图片)。
在 Notes Content 向导中,选择一个内容组来管理内容,例如默认值。
选择 From DXL。
指定一个在导航内显示的名称,例如 “Identity management project plan”。
单击 Browse,然后导航到 Notes 文档的在线地址。
单击 OK 关闭文件浏览对话框。
在返回到 Notes Content 向导时,单击 Next。
找到工具箱中的 Notes 文档组并将其拖放进导航模板中。
返回到 Notes 选项卡页面。
双击文档被分配到的那个内容组的灰色条形图标。
通过您为这组文档提供的标题找到这组 Notes 文档。
选中这些文档。
将这些文档拖放到导航模板中的一个位置。
有关如何编写一个能导出 DXL 文档格式的 Notes 文档的 LotusScript 例程的介绍超出了本文的讨论范围,但在 Internet 上可以找到关于 Lotus Notes 编程和 DXL 格式的参考信息。对于那些已经很熟悉 Lotus Notes 编程的人,可以参考下面所示的方法导出一组文件:
如果您只被允许在 Notes 数据库创建新的视图,那么必须在本地复制您的 Notes 数据库。
从 Lotus Notes 内的菜单栏选择 Create > View 。指定一个 SELECT 语句来定义哪个文档将被显示在这个视图中。
选择 Save and Customize,打开 Lotus Notes 程序员的面板。
在这个程序员面板中,选择 Create > Action 并配置一个新的 ExportDXL 动作。
编辑这个 ExportDXL 动作以便包括一个 LotusScript,由它将视图内的文档导出到系统上指定位置的一个 .dxl 文件。
保存此动作并退出程序员面板。
查找这个在顶部包括了一个 ExportDXL 按钮的新视图。
通过单击 ExportDXL 按钮测试 LotusScript,然后再查看有可能包含 .dxl 文件的那个目录。
结束语
在本文中,您学习了通过一个解决方案信息中心(用 Toolkit for Custom and Reusable Solution Information 得到)积累可重用内容以为您的 IT 解决方案编制文档的四个技巧。当然,一旦您捕捉到内容,就意味着内容会过期。“使用定制 Eclipse 信息中心为 IT 解决方案编制文档” 系列的下一篇文章将会介绍如何管理重用内容内的变更。
下载
描述 | 名字 | 大小 | 下载方法 |
编制文档插件模板 | os-eclipse-infocenter2-TKCARSI-TEMPLATE.zip | 266KB | HTTP |
解决方案信息项目示例 | os-eclipse-infocenter2-TKCARSI-SAMPLE.zip | 11,000KB | HTTP |
赞助商链接