flex利用asdoc生成doc和制作chm
2013-07-12 10:56
141 查看
How to set up ASDoc in Flex Builder
I’ve basically spent about a day working out how to use ASDoc, and all I can say is, what a nightmare! If I wanted this kind of unintuitive, problem-ridden, poorly-documented ridiculousness I’d be a Linux user! (no offense meant, but you Linux guys seem to thrive on this sort of thing!)Excluding external librariesOur project has loads of external classes in libraries (one is papervision, others are various Plug-in Media libs), and I really would rather it didn’t try to document them all in the same documentation. And I couldn’t figure out how to stop ASDocs from trying to compile the classes in these libraries.And if you don’t include the libraries, ASDoc fails badly! So I could either include them in to the docs (which seemed to break anyway) or just exclude them. But is there a way to exclude them?It turns out that there is, and that is to list every class that you want to exclude! Er yeah that’s probably about 2,000 classes so not going to happen!Although there is a handy way to generate this HUGE list of classes using the AIR app Dita. But I think I’ve kinda worked out how to use ASDocs now in a way that stops you needing to do that.Adding external swcsThe big secret that no one seemed to be telling me! If you add a swc file it no longer fails to find the classes you’re referring to. But most importantly it doesn’t try to write docs for them!So here’s how we set it up :Step 1 : Set up an external tool in Flex.Open Flex Builder (we’re using FB 3). See that little green play button with a suitcase on it? In the top left? Click on the down arrow next to it and then “Open external tools dialog”.Step 2 :Click on the “New Launch Configuration” Button. it’s the white sheet of paper with a “+” on it.Step 3 : Find your asdoc file.Give it a name. Maybe ASDocs or something equally unimaginative. Then set up the Location field; click on Browse File System and find your ASDoc file in the Flex SDK. For me it was in /Applications/Flex Builder 3/sdks/4.0.0.4021/bin/asdoc. If you’re on a PC you should probably point to asdoc.exe.Step 4 : Point to the project folder.In the “Working Directory” field, type ${project_loc} – this will point to the project folder for whichever project you are currently in.Step 5 : Set up the arguments.in the arguments field point to your source path with the following two arguments :-source-path src
-doc-sources srcThis assumes that you set up your projects with the default source folder called src. So it’ll look into your project folder’s src to find all the classes to make docs for.And then add arguments to point to the swcs for your library projects, for us it’s :-external-library-path=/Users/seb/Documents/FBWorkspace/PluginLibs/bin
-external-library-path=/Users/seb/Documents/FBWorkspace/PluginBrain/bin
-external-library-path=/Users/seb/Documents/FBWorkspace/Papervision3D/binOf course this assumes that you use library projects in Flex Builder. I guess this will work as long as you have swcs for your code library. Either way you need to point at it.I’m sure that this won’t work for all of you but I haven’t seen this approach documented anywhere so I thought it may help. And good luck!
thanks:http://sebleedelisle.com/2009/03/how-to-set-up-asdoc-in-flex-builder/CHM制作精灵_V1.18.rar (2.9 MB)
下载次数: 14
相关文章推荐
- ASDoc生成Flex API Document
- 关于如何利用Pocket CHM Pro制作帮助文档
- Flex AsDoc 文档API生成工具 可以生成和Adobe的ActionScript3帮助一样的文档
- Flex 利用Image制作动态菜单
- Flex帮助文档(html格式)制作及ASDoc的使用
- 利用HeaderDoc自动生成API文档
- ASDoc生成Flex API Document
- ASP.NET利用输出流生成下载文件(doc、xml..)
- 利用MetaProducts Inquiry 制作离线版网页chm电子书
- 用flash制作SWC文件,生成flex自定义组件【站优教程】
- 利用免费软件备份博客并制作成CHM
- 用flash制作SWC文件,生成flex自定义组件
- flex 利用饼图生成内部环状图
- DoxyGen生成的html制作成CHM后目录为乱码的问题
- DoxyGen生成的html制作成CHM后目录为乱码的问题
- 利用FluorineFX自动生成Flex项目配置和代码
- Flex文档API生成工具AsDoc
- 利用html文件生成chm帮助文件的方法
- Flex中利用AMFPHP开发包通过PHP调用轻松生成输出PDF文档
- java利用Freemarker模板生成格式友好的doc或者docx文档