fmddlmyy吧 关注:121贴子:3,018
  • 13回复贴,共1

关于"使用doxygen为C/C++程序生成中文文档(上)"

收藏回复

  • 218.17.227.*
尊敬的伐木丁丁鸟鸣嘤嘤:
   您好!!!
   在认真读过你的文章“使用doxygen为C/C++程序生成中文文档(上)”,并按照您的步骤执行后却不能得到您最

后所生成的chm文件。因而写信详细询问学习。
1.项目名(PROJECT_NAME):谁养鱼
  是不是要文档化的VC的project的名字就是"谁养鱼",还是这个名字可以是任意的,给其它的名字也可以??

2.生成的配置文件Doxygen保存在fish\doc目录下??

3.Input页中有  INPUT选项: ..\src   为什么不是..\fish\src??
  在开始时不是创建的fish\src,并把源程序放在fish\src里??

4.建立文件html_foot:它有没有后缀名?? 这个文件应该存放在什么目录下???
还是创建时是这样的:
  <p align="right"><A HREF="http://www.fmddlmyy.cn/text20.html" target="_top">穷举和推理:用C++程序  

求解“谁养鱼”</A></p>
  </BODY>
  </HTML>
而为什么不是下面这样的:
  <HTML>
  <BODY>
  <p align="right"><A HREF="http://www.fmddlmyy.cn/text20.html" target="_top">穷举和推理:用C++程序  

求解“谁养鱼”</A></p>
  </BODY>
  </HTML>

5.在完成配置文件之后,接着是"从命令行进入doc目录后运行rebuild.bat" 还是运行doxywizard的step3:Specify 

the directory from which tl run doxygen ???

  非常期待您的回复!!!
  向您表示真诚的谢意!!!


1楼2007-07-13 18:43回复
    1 随便什么名字
    2 随便什么目录,只要配置好
    3 源程序在fish/src,doxyfile(即doxygen工作目录)在fish/doc
    4 随便放哪里,配置文件里指对即可。foot当然没有头,只有下半截。head只有上半截。详见doxygen文档
    5 在doxywizard运行也可以,相当于运行build.bat。没有后续的转码、生成chm。

    请见原文的后记。我在那里放了完整的工作环境。


    禁言 |2楼2007-07-15 20:27
    回复
      • 218.17.227.*
      您好!!
       非常感谢您的回复。
       通过您的回复,弄明白很多东西,中文问题也解决了。但是却得不到您最后得到的结果,希望能指点一二:
       1。运行rebuilt.bat时出现以下的错误:
       HHC6000: Error: An internal file could not be created. Make certain there is eno
       ugh disk space on the drive where you are compiling your file.
       HHC5007: Error: Fatal navigational compilation error. This is likely the result
       of an invalid contents (.hhc) file.
       首先磁盘空间肯定是足够的。
       
       2。把 DOT_IMAGE_FORMAT 设成 gif 后,build.log就没有出现什么错误提示了。

       3。对了,还有就是doxygen不用任何设置,它就可以直接应用Graphviz.exe吗??

       4."请见原文的后记。我在那里放了完整的工作环境。" 没有找到,请指出具体的链接。

       另外附上我的Doxyfile,再次谢过!!!

      # Doxyfile 1.5.2

      #---------------------------------------------------------------------------
      # Project related configuration options
      #---------------------------------------------------------------------------
      DOXYFILE_ENCODING = GBK
      PROJECT_NAME = wangrui
      PROJECT_NUMBER = 1.0
      OUTPUT_DIRECTORY = output
      CREATE_SUBDIRS = NO
      OUTPUT_LANGUAGE = Chinese
      BRIEF_MEMBER_DESC = YES
      REPEAT_BRIEF = YES
      ABBREVIATE_BRIEF = "The $name class" \
       "The $name widget" \
       "The $name file" \
       is \
       provides \
       specifies \
       contains \
       represents \
       a \
       an \
       the
      ALWAYS_DETAILED_SEC = NO
      INLINE_INHERITED_MEMB = NO
      FULL_PATH_NAMES = NO
      STRIP_FROM_PATH = "C:/Documents and Settings/wangrui/"
      STRIP_FROM_INC_PATH = 
      SHORT_NAMES = NO
      JAVADOC_AUTOBRIEF = NO
      MULTILINE_CPP_IS_BRIEF = NO
      DETAILS_AT_TOP = NO
      INHERIT_DOCS = YES
      SEPARATE_MEMBER_PAGES = NO
      TAB_SIZE = 8
      ALIASES = 
      OPTIMIZE_OUTPUT_FOR_C = NO
      OPTIMIZE_OUTPUT_JAVA = NO
      BUILTIN_STL_SUPPORT = NO
      CPP_CLI_SUPPORT = NO
      DISTRIBUTE_GROUP_DOC = NO
      SUBGROUPING = YES
      #---------------------------------------------------------------------------
      # Build related configuration options
      #---------------------------------------------------------------------------
      EXTRACT_ALL = NO
      EXTRACT_PRIVATE = NO
      EXTRACT_STATIC = NO
      EXTRACT_LOCAL_CLASSES = YES
      EXTRACT_LOCAL_METHODS = NO
      HIDE_UNDOC_MEMBERS = NO
      HIDE_UNDOC_CLASSES = NO
      HIDE_FRIEND_COMPOUNDS = NO
      HIDE_IN_BODY_DOCS = NO
      INTERNAL_DOCS = NO
      CASE_SENSE_NAMES = NO
      HIDE_SCOPE_NAMES = NO
      SHOW_INCLUDE_FILES = YES
      INLINE_INFO = YES
      SORT_MEMBER_DOCS = YES
      SORT_BRIEF_DOCS = NO
      SORT_BY_SCOPE_NAME = NO
      GENERATE_TODOLIST = YES
      GENERATE_TESTLIST = YES
      GENERATE_BUGLIST = YES
      GENERATE_DEPRECATEDLIST= YES
      ENABLED_SECTIONS = 
      MAX_INITIALIZER_LINES = 30
      SHOW_USED_FILES = YES
      SHOW_DIRECTORIES = NO
      FILE_VERSION_FILTER = 
      #---------------------------------------------------------------------------
      # configuration options related to warning and progress messages
      #---------------------------------------------------------------------------
      QUIET = NO
      WARNINGS = YES
      WARN_IF_UNDOCUMENTED = YES
      WARN_IF_DOC_ERROR = YES
      WARN_NO_PARAMDOC = NO
      WARN_FORMAT = "$file:$line: $text"
      WARN_LOGFILE = build.log
      #---------------------------------------------------------------------------
      


      3楼2007-07-16 20:27
      回复
        • 218.17.227.*
        # configuration options related to the input files
        #---------------------------------------------------------------------------
        INPUT = "C:/Documents and Settings/wangrui"
        INPUT_ENCODING = GBK
        FILE_PATTERNS = *.c \
         *.cc \
         *.cxx \
         *.cpp \
         *.c++ \
         *.d \
         *.java \
         *.ii \
         *.ixx \
         *.ipp \
         *.i++ \
         *.inl \
         *.h \
         *.hh \
         *.hxx \
         *.hpp \
         *.h++ \
         *.idl \
         *.odl \
         *.cs \
         *.php \
         *.php3 \
         *.inc \
         *.m \
         *.mm \
         *.dox \
         *.py
        RECURSIVE = NO
        EXCLUDE = 
        EXCLUDE_SYMLINKS = NO
        EXCLUDE_PATTERNS = 
        EXCLUDE_SYMBOLS = 
        EXAMPLE_PATH = 
        EXAMPLE_PATTERNS = *
        EXAMPLE_RECURSIVE = NO
        IMAGE_PATH = 
        INPUT_FILTER = 
        FILTER_PATTERNS = 
        FILTER_SOURCE_FILES = NO
        #---------------------------------------------------------------------------
        # configuration options related to source browsing
        #---------------------------------------------------------------------------
        SOURCE_BROWSER = YES
        INLINE_SOURCES = NO
        STRIP_CODE_COMMENTS = YES
        REFERENCED_BY_RELATION = YES
        REFERENCES_RELATION = YES
        REFERENCES_LINK_SOURCE = YES
        USE_HTAGS = NO
        VERBATIM_HEADERS = YES
        #---------------------------------------------------------------------------
        # configuration options related to the alphabetical class index
        #---------------------------------------------------------------------------
        ALPHABETICAL_INDEX = NO
        COLS_IN_ALPHA_INDEX = 5
        IGNORE_PREFIX = 
        #---------------------------------------------------------------------------
        # configuration options related to the HTML output
        #---------------------------------------------------------------------------
        GENERATE_HTML = YES
        HTML_OUTPUT = html
        HTML_FILE_EXTENSION = .html
        HTML_HEADER = 
        HTML_FOOTER = html_foot
        HTML_STYLESHEET = 
        HTML_ALIGN_MEMBERS = YES
        GENERATE_HTMLHELP = YES
        CHM_FILE = 
        HHC_LOCATION = 
        GENERATE_CHI = NO
        BINARY_TOC = NO
        TOC_EXPAND = NO
        DISABLE_INDEX = NO
        ENUM_VALUES_PER_LINE = 4
        GENERATE_TREEVIEW = NO
        TREEVIEW_WIDTH = 250
        #---------------------------------------------------------------------------
        # configuration options related to the LaTeX output
        #---------------------------------------------------------------------------
        GENERATE_LATEX = NO
        LATEX_OUTPUT = latex
        LATEX_CMD_NAME = latex
        MAKEINDEX_CMD_NAME = makeindex
        COMPACT_LATEX = NO
        PAPER_TYPE = a4wide
        EXTRA_PACKAGES = 
        LATEX_HEADER = 
        PDF_HYPERLINKS = NO
        USE_PDFLATEX = NO
        LATEX_BATCHMODE = NO
        LATEX_HIDE_INDICES = NO
        #---------------------------------------------------------------------------
        # configuration options related to the RTF output
        #---------------------------------------------------------------------------
        GENERATE_RTF = NO
        RTF_OUTPUT = rtf
        COMPACT_RTF = NO
        RTF_HYPERLINKS = NO
        RTF_STYLESHEET_FILE = 
        RTF_EXTENSIONS_FILE = 
        #---------------------------------------------------------------------------
        # configuration options related to the man page output
        #---------------------------------------------------------------------------
        GENERATE_MAN = NO
        MAN_OUTPUT = man
        MAN_EXTENSION = .3
        MAN_LINKS = NO
        #---------------------------------------------------------------------------
        


        4楼2007-07-16 20:27
        回复
          • 218.17.227.*
          # configuration options related to the XML output
          #---------------------------------------------------------------------------
          GENERATE_XML = NO
          XML_OUTPUT = xml
          XML_SCHEMA = 
          XML_DTD = 
          XML_PROGRAMLISTING = YES
          #---------------------------------------------------------------------------
          # configuration options for the AutoGen Definitions output
          #---------------------------------------------------------------------------
          GENERATE_AUTOGEN_DEF = NO
          #---------------------------------------------------------------------------
          # configuration options related to the Perl module output
          #---------------------------------------------------------------------------
          GENERATE_PERLMOD = NO
          PERLMOD_LATEX = NO
          PERLMOD_PRETTY = YES
          PERLMOD_MAKEVAR_PREFIX = 
          #---------------------------------------------------------------------------
          # Configuration options related to the preprocessor 
          #---------------------------------------------------------------------------
          ENABLE_PREPROCESSING = YES
          MACRO_EXPANSION = NO
          EXPAND_ONLY_PREDEF = NO
          SEARCH_INCLUDES = YES
          INCLUDE_PATH = 
          INCLUDE_FILE_PATTERNS = 
          PREDEFINED = 
          EXPAND_AS_DEFINED = 
          SKIP_FUNCTION_MACROS = YES
          #---------------------------------------------------------------------------
          # Configuration::additions related to external references 
          #---------------------------------------------------------------------------
          TAGFILES = 
          GENERATE_TAGFILE = 
          ALLEXTERNALS = NO
          EXTERNAL_GROUPS = YES
          PERL_PATH = /usr/bin/perl
          #---------------------------------------------------------------------------
          # Configuration options related to the dot tool 
          #---------------------------------------------------------------------------
          CLASS_DIAGRAMS = YES
          MSCGEN_PATH = 
          HIDE_UNDOC_RELATIONS = YES
          HAVE_DOT = YES
          CLASS_GRAPH = YES
          COLLABORATION_GRAPH = YES
          GROUP_GRAPHS = YES
          UML_LOOK = YES
          TEMPLATE_RELATIONS = NO
          INCLUDE_GRAPH = YES
          INCLUDED_BY_GRAPH = YES
          CALL_GRAPH = YES
          CALLER_GRAPH = YES
          GRAPHICAL_HIERARCHY = YES
          DIRECTORY_GRAPH = YES
          DOT_IMAGE_FORMAT = gif
          DOT_PATH = 
          DOTFILE_DIRS = 
          DOT_GRAPH_MAX_NODES = 50
          DOT_TRANSPARENT = NO
          DOT_MULTI_TARGETS = NO
          GENERATE_LEGEND = YES
          DOT_CLEANUP = YES
          #---------------------------------------------------------------------------
          # Configuration::additions related to the search engine 
          #---------------------------------------------------------------------------
          SEARCHENGINE = NO


          5楼2007-07-16 20:27
          回复
            禁言 |7楼2007-07-17 12:27
            回复
              • 218.17.227.*
              您好!!!谢谢您的回复.

              还有一个问题:为什么生成的chm文件中png图片不能正常显示???


              8楼2007-07-17 19:17
              回复
                • 218.17.227.*
                请问丁丁TZ,可不可以对上述问题给予解答???
                比较着急,等了好几天了.谢谢!!!


                9楼2007-07-20 14:25
                回复
                  我可以正常显示.而且我也把我的工作目录放到了
                  http://www.fmddlmyy.cn/download/doxytool/fish.rar 
                  如果你用这个目录rebuild的chm,也不能正常显示png图片。那就只可能是安装问题了。
                  我曾经在一台新装电脑上用从我网页下载的工具建立doxygen工作环境,也可以正常工作。

                  你如果一定说不行。我也没什么办法。或者你把不行的工作目录发给我(fmdd@263.net),我有空时帮你看看。不过我对个人提供的技术支持,一般是要收费的。


                  禁言 |10楼2007-07-20 18:31
                  收起回复
                    • 218.17.227.*
                    谢谢丁丁TZ,真的很感谢。
                    我先自己看看吧。谢谢了


                    11楼2007-07-21 18:17
                    回复
                      • 61.149.149.*
                      我想其实大家可能没有好好读这篇文档,因为我一次就成功了,希望使用的时候认真读写作者的文档


                      12楼2007-10-29 11:42
                      回复
                        • 202.120.39.*
                        你好,我直接运行你的rebuild.bat,
                        生成的chm只有77k,没有png图片,
                        你的chm有280k。
                        麻烦指点。
                        谢谢啊


                        13楼2008-11-18 22:31
                        回复
                          不好意思。我很长时间不用doxygen


                          禁言 |14楼2008-11-18 23:05
                          回复