首页 > 解决方案 > Doxygen:参数表的列宽问题

问题描述

在 Doxygen 文档的 pdf 输出中,函数参数表的宽度不正确。有没有人有解决这个问题的方法?

见下图

这是我正在使用的 Doxyfile:

PROJECT_NAME           = my project name
PROJECT_NUMBER         = 1.0.0
PROJECT_BRIEF          = my project synapsis
PROJECT_LOGO           = logo.png
OUTPUT_DIRECTORY       = ./
CREATE_SUBDIRS         = YES
FULL_PATH_NAMES        = NO
JAVADOC_AUTOBRIEF      = YES
OPTIMIZE_OUTPUT_FOR_C  = YES
EXTRACT_ALL            = YES
EXTRACT_STATIC         = YES
HIDE_SCOPE_NAMES       = YES
GENERATE_TODOLIST      = NO
GENERATE_TESTLIST      = NO
GENERATE_BUGLIST       = NO
GENERATE_DEPRECATEDLIST= NO
SHOW_USED_FILES        = NO
LAYOUT_FILE            = DoxygenLayout.xml
INPUT                  = ../Source \
                         ./README.md \
                         ../Include/header.h \
                         ../Include/Global_Structs.h
RECURSIVE              = YES
EXCLUDE                = ../Source/clencurt_gen.c \
                         ../Source/cubature.c \
                         ../Source/hcubature.c \
                         ../Source/pcubature.c
USE_MDFILE_AS_MAINPAGE = README.md
ALPHABETICAL_INDEX     = NO
#AM: I modified the header.html file to remove the Project_Name from the #header of the doxygen page. In order to save a header file, first I ran 
#doxygen -w html header.html footer.html customdoxygen.css 
#which creats the three files that doxygen uses to start the html page, and #then costumized the header file.
HTML_HEADER            = ./header.html
DISABLE_INDEX          = YES
GENERATE_TREEVIEW      = YES
COMPACT_LATEX          = YES
LATEX_HEADER           = header.tex
LATEX_EXTRA_STYLESHEET = 
LATEX_EXTRA_FILES      = transparent.png
GENERATE_RTF           = YES
GENERATE_MAN           = YES
INCLUDE_PATH           = ../Include
INCLUDE_FILE_PATTERNS  = *.h
SKIP_FUNCTION_MACROS   = NO
CLASS_DIAGRAMS         = NO
HAVE_DOT               = YES
CALL_GRAPH             = YES
CALLER_GRAPH           = YES

这里是我对header.tex文件所做的修改,基本上我只是改变了latex输出的titlepage。

\begin{titlepage}
\vspace*{2cm}
\begin{center}%
\includegraphics[width=0.7 \textwidth]{../transparent.png}\\
\vspace*{2cm}
{\Large Version 1.0.0}\\
\vspace*{.6cm}
{\Large Developer: name}\\
\vspace*{2.5cm}
{\large $generatedby Doxygen $doxygenversion}\\
%%BEGIN LATEX_TIMESTAMP
\vspace*{0.5cm}
{\small $datetime}
%%END LATEX_TIMESTAMP
\end{center}
\end{titlepage}

C代码中函数定义和注释的片段:

/** 
 * Compute the cold dark matter concentration-mass relation
 *   
 * @param M      Input: halo mass in the unit of solar mass
 * @param z      Input: redshift of interest
 * @return the cdm concentration
 */

double concentration_cdm(double M, double z)
{
 
  double result = 0.;

  *
  Do some calculations to compute result 
  *

  return result;
}

标签: latexdoxygen

解决方案


推荐阅读