ASP网站制作之Doxygen设置（翻译）
帮助用户快速实现各种应用服务，ASP商有整合各方面资源的能力，可在短期内为用户提供所需的解决方案。例如，典型的ERP安装，如果要在客户端安装的话需要半年到二年的时间，但是美国的一些ASP商如USI和CORIO能在90—120天内提供ERP应用方案。利用Doxygen文档开辟工具时必要举行的设置：可实行文件doxygen是原代码剖析和天生文档的次要工具.请看Doxygenusage章节来猎取更具体的利用匡助.
Doxytag可实行文件---仅仅是用来完成匡助程序员天生不必要看原代码就可以懂得工程部署信息的doxygen文档的参考文档(比方：那些利用doxygen天生的文档).请看Doxytagusage章节来取得更多的利用匡助.
doxywizard可实行文件很简单就可以利用,它是用来为doxygen工具供应设置信息的一个图形化工具.
上面的图显现了开辟工具之间的互相干系信息:
http://www.stack.nl/~dimitri/doxygen/infoflow.gif
图：Doxygeninformationflow
Step1:创立一个设置文件
Doxygen利用一个设置文件来断定它一切的设置.每一个工程都应当有它本人的设置文件.
一个工程能够只要一个原文件,也能够是工程中一切原文件的递回扫描失掉的原文件的树状视图。
为了简化doxygen天生设置文件的事情,doxygen能够为你供应一个模板化的设置文件.
1.为了创立一个模板化的设置文件，只必要挪用doxygen并从命令行中敲进-g:
doxygen-g<config-file>
个中<config-file>是某个模板化的设置文件的文件名.假如你省略了文件名,doxygen会为你天生一个默许的Doxyfile的设置文件.假如<config-file>是一个已存在的文件名,doxygen在天生设置模板之前，将会天生一个<config-file>.Bak备份文件。
2.假如你利用-(比方：减号)作为文件名doxygen将会把你从键盘输出的笔墨看成设置文件名。
设置文件有着和Makefile类似的格局.次要是：包括了良多的“标记”分派符格局(tags):
比方：
TAGNAME=VALUEor
TAGNAME=VALUE1VALUE2...
在天生文档模板时，你可使用默许（即：保存年夜多半的TAGS）具体信息请看Configuration这一章节来猎取更多的信息.
假如你不想利用文本编纂工具来编写设置文件,你应当看看doxywizard章节的形貌,它是一个能够用来创立/读/写doxygen设置文档的图形化工具，同时它也能够在路径中举行全路径设置来使doxygen一般事情。
3.关于一个有很少的原文件和头文件构成的C/C++工程来讲,你能够保存INPUT标记为“空”，那末doxygen将会在以后路径下搜刮原文件.
4.假如你的工程很年夜，你应当把你的工程文件的“根目次”放在INPUT标记前面,必要增加到工程中的文件应当放到FILE_PATTERNS标记以后(比方：*.cpp*.h).最少是婚配了1项的文件才干被doxygen程序读进并剖析(假如省略了这项设置，则会利用doxygen设置列表中的格局).
5.假如想要递回对原文件树举行剖析必需设置RECURSIVE标记为YES.
6.想在doxygen中利用更多的自界说划定规矩举行剖析，必需利用EXCLUDE标记和EXCLUDE_PATTERNS标记。
7.想疏忽一切的test路径下的文件，利用上面的情势:
EXCLUDE_PATTERNS=*/test/*
8.关于C/C++文件Doxygen一般间接举行剖析。假如文件有.idl或.odl扩大名，则doxygen会把它视为IDL文件。
8.有.java扩大名的将被视为Java文件.
9.利用.cs作为扩大名的文件将会视为C#文件.
10.利用.php,.php4扩大名的文件和用.inc或.phtml扩大名的文件将被视为PHP原文件.
11.假如你想用doxygen为已存在的工程天生文档。你起首要设想一下你的工程文档终极利用甚么样的格局排版，为了完成如许的方针，你必需要设置EXTRACT_ALL标记为YES.然后，doxygen体现出来的是它晓得了一切你的工程文件的设置方针。
注重：假如设置EXTRACT_ALL标记为YES。则：undocumentedmembers之类的告诫将不会再发生。
12.利用doxygen来剖析一个现存的源代码的某个部分或全体文件能够更明晰的分明源代码各个功效模块的界说和要完成的功效和它们之间的交织参考。
13.利用Doxygen天生交织参考必需设置SOURCE_BROWSER标记为YES。也能够间接经由过程设置INLINE_SOURCES标记为YES来完成把工程的一切源代码包括进文档中。(如许便利了代码的通览).
Step2:Runningdoxygen
Togeneratethedocumentationyoucannowenter:
doxygen<config-file>
Doxygen将会在输入路径中创立html,rtf,latex和/或man路径。路径和路径中的文件格局是对应的HTML,RTF,和Unix-Man格局.
默许的路径是doxygen的安装路径。可使用OUTPUT_DIRECTORY,HTML_OUTPUT,RTF_OUTPUT,LATEX_OUTPUT,和MAN_OUTPUT标记来自界说设置文档的输入路径。假如输入路径不存在doxygen将会为你创立一个输入路径。
天生的HTML能够经由过程利用扫瞄器扫瞄位于html路径下的index.html文件.假如扫瞄器撑持层叠款式表(CSS)那就更棒了。
天生的必需要先用编译器举行编译(我利用teTeX0.9版本，个中包括了3.14159).为了简化编译文档的天生历程，doxygen在latex路径下供应了一个Makefile。在命令行latex路径下敲进make将会天生一个refman.dvi文件。(假定你有一个文件叫做makeofcourse).你能够经由过程利用xdvi命令来检察这个文件大概利用dvips把它转换成一个后缀是.ps的文件refman.ps。
想完成分红2页的效果可使用makeps_2on1命令。PostScript文件终极会被发送到PostScript打印机输入。假如你没有PostScript打印机，你可使用ghostscript命令把PostScript文件格局转换成你的打印性能够辨认的文件格局。假如你已安装了ghostscript注释程序，那末能够把文件转换成PDF格局，这只必要敲进makepdf(或makepdf_2on1)。
想天生PDF文件，你要把PDF_HYPERLINKS标记设置成YES。
发生的man页面文件能够经由过程man程序来举行检察。可是，你必需断定man路径有响应的情况变量设置(一样平常在MANPATH情况变量中)。注重：man页面文件的格局有一些限定，以是有些信息(像：class图，交织参考，公式等)将会丧失失落。
Step3:Documentingthesources
只管源代码体例文档的被作为第3步，可是，在某些新的工程中，这个是作为第1步来做的。这里，我假定你已有了一些想用doxygen来对其举行文档化（形貌API接口和感化）的源代码。
如EXTRACT_ALL选项被设置成NO（默许情形下是NO）那末doxygen只会为已文档化的成员，文件，类和定名空间天生文档。假如你的文档属于这类情形，该怎样办呢？关于成员，类和定名空间有2种基础的设置：
1.成员，类或定名空间的后面布置一个形貌或界说的块儿。关于文件，类和定名空间成员来讲，doxygen同意间接在成员前面布置文档。你能够参考：
Specialdocumentationblocks懂得更多特别块儿的设置。
2.想在任何中央部署特别的文档块儿（任何的文件或任何的路径）和在文档块中增加一个“布局化”的命令。“布局化”的命令用来设置一个可被体例成文档的链接。(e.g.amember,class,namespaceorfile)。请看：Documentationatotherplaces懂得更多的布局化命令的利用办法。
文件只能利用下面2中的办法举行设置，由于没有举措把一个文档块儿放到一个文件的后面。
固然，文件成员（函数，变量，范例界说，define）不必要显现的利用“布局化”命令，只必要把特别的文档块儿放到文件中的最后面或最初面就能够了。
文档外部的文档块儿在输入为HTML格局或其他格局输入文件之行进行doxygen的语法剖析：
它实际上是在举行上面的步骤行进行剖析：
文档外部的特别“布局化”命令被实行的时分。请看：SpecialCommands章节猎取一切的命令参考信息。
假如某行中利用“空格+前面利用1个或多个*号”，大概是良多的“空格”符，则一切的空格和“*”号城市被删除。
一切的“空行”城市被视为“图形分开符”。这项布置可使你有“部署自界说图形分开符”的才能，以发生更具可读性的文档。
Doxygen将会为一切已回档的classes天生链接。
假如在文档中找到切合doxygen文档格局的成员，那末也会为members创立链接。请参考：Automaticlinkgeneration猎取更多的怎样主动化文档链接。
文档中的HTML标记被注释和转换成响应的输入。请看：HTMLCommand</p>缺点：正版成本价格贵（盗版就不说了）、不够安全，大多数服务器用windows系统，没有linux安全 Application:这个存储服务端的数据，如果不清除，会直到web应用程序结束才清除(例如重启站点) ASP主要是用好六个对象，其实最主要的是用好其中两个：response和request，就可以随心所欲地控制网页变换和响应用户动作了。 ASP.Net和ASP的最大区别在于编程思维的转换，而不仅仅在于功能的增强。ASP使用VBS/JS这样的脚本语言混合html来编程，而那些脚本语言属于弱类型、面向结构的编程语言，而非面向对象，这就明显产生以下几个问题： 从事这个行业，那么你可以学ASP语言，简单快速上手，熟练dreamweav排版，写asp代码，熟练photoshop处理图片，打好基础就行了 ASP.Net和ASP的最大区别在于编程思维的转换，而不仅仅在于功能的增强。ASP使用VBS/JS这样的脚本语言混合html来编程，而那些脚本语言属于弱类型、面向结构的编程语言，而非面向对象，这就明显产生以下几个问题： 我认为比较好的方法是找一些比较经典的例子，每个例子比较集中一种编程思想而设计的。 Session:这个存储跟客户端会话过程的数据，默认20分钟失效 ASP.Net摆脱了以前ASP使用脚本语言来编程的缺点，理论上可以使用任何编程语言包括C++,VB,JS等等，当然，最合适的编程语言还是MS为.NetFrmaework专门推出的C(读csharp)，它可以看作是VC和Java的混合体吧。 完全不知道到底自己学的是什么。最后，除了教程里面说的几个例子，还是什么都不会。
页:
[1]