Doxygen
Loading...
Searching...
No Matches
qhp.cpp File Reference
#include <algorithm>
#include <memory>
#include <string.h>
#include <vector>
#include <cassert>
#include <mutex>
#include "config.h"
#include "debug.h"
#include "doxygen.h"
#include "groupdef.h"
#include "memberdef.h"
#include "message.h"
#include "qhp.h"
#include "textstream.h"
#include "util.h"
#include "stringutil.h"
#include "portable.h"
#include "language.h"
#include "version.h"
Include dependency graph for qhp.cpp:

Go to the source code of this file.

Classes

class  QhpSectionTree
struct  QhpSectionTree::Node
class  Qhp::Private

Functions

static void writeIndent (TextStream &t, int indent)
static DString getFullProjectName ()
static DString makeFileName (const DString &withoutExtension)
static DString makeRef (const DString &withoutExtension, const DString &anchor)

Variables

static std::once_flag g_blankWritten

Function Documentation

◆ getFullProjectName()

DString getFullProjectName ( )
static

Definition at line 162 of file qhp.cpp.

163{
164 DString projectName = Config_getString(PROJECT_NAME);
165 DString versionText = Config_getString(PROJECT_NUMBER);
166 if (projectName.empty()) projectName="Root";
167 if (!versionText.empty()) projectName+=" "+versionText;
168 return projectName;
169}
A String class for use with Doxygen wrapping std::string and adding some additional functionality off...
Definition dstring.h:88
bool empty() const
Returns true iff the string is empty (std::string compatible alias for isEmpty()).
Definition dstring.h:152
#define Config_getString(name)
Definition config.h:32

References Config_getString, and DString::empty().

Referenced by Qhp::initialize().

◆ makeFileName()

DString makeFileName ( const DString & withoutExtension)
static

Definition at line 171 of file qhp.cpp.

172{
173 DString result=withoutExtension;
174 if (!result.empty())
175 {
176 if (result.at(0)=='!') // relative URL -> strip marker
177 {
178 result=result.mid(1);
179 }
180 else // add specified HTML extension
181 {
183 }
184 }
185 return result;
186}
DString mid(size_t index, size_t len=npos) const
Definition dstring.h:322
char & at(size_t i)
Returns a reference to the character at index i.
Definition dstring.h:690
void addHtmlExtensionIfMissing(DString &fName)
Definition util.cpp:3933

References addHtmlExtensionIfMissing(), DString::at(), DString::empty(), and DString::mid().

Referenced by makeRef().

◆ makeRef()

DString makeRef ( const DString & withoutExtension,
const DString & anchor )
static

Definition at line 188 of file qhp.cpp.

189{
190 //printf("QHP::makeRef(%s,%s)\n",withoutExtension,anchor);
191 if (withoutExtension.empty()) return DString();
192 DString result = makeFileName(withoutExtension);
193 if (anchor.empty()) return result;
194 return result+"#"+anchor;
195}
static DString makeFileName(const DString &withoutExtension)
Definition qhp.cpp:171

References DString::empty(), and makeFileName().

Referenced by Qhp::addContentsItem(), and Qhp::addIndexItem().

◆ writeIndent()

void writeIndent ( TextStream & t,
int indent )
inlinestatic

Definition at line 38 of file qhp.cpp.

39{
41 {
42 for (int i=0;i<indent;i++) t << " ";
43 }
44}
@ Qhp
Definition debug.h:45
static bool isFlagSet(const DebugMask mask)
Definition debug.cpp:133

References Debug::isFlagSet(), and Debug::Qhp.

Referenced by Qhp::addIndexItem(), Qhp::finalize(), Qhp::initialize(), QhpSectionTree::traverse(), and QhpSectionTree::writeToc().

Variable Documentation

◆ g_blankWritten

std::once_flag g_blankWritten
static

Definition at line 35 of file qhp.cpp.

Referenced by Qhp::addContentsItem().