Frequently Asked Questions
Broken image links and relative links
DocsForge tries to resolve any relative links or image links found in your markdown files automatically. However, there are always edge cases where this automatic process fails. In such cases you can either file an issue or change the link to an absolute url and the automatic process won't touch it.
Broken image links
DocsForge doesn't store images locally. The automatic process changes any relative image links to absolute external url. If it fails, note the following:
Github advises users to use the following format to create absolute image links:
For example, instead of linking to
inside a markdown file it would look like:
If the file is inside a wiki repository, it should be accessed in the following way:
Your sidebar section Public API has 0 pages
If you get this error message, something is wrong with your configuration file.
No source files were read.
Check that your
excludeAPIfields don't result in an empty file list being fed to the autodoc engine.
The source files are empty due to
For example, consider a file
my_file.hwith the following content:
#ifdef MY_DEFINE #define MY_DEFINE 10 ... lines of code #endif
MY_DEFINEis not defined in any of the files being fed to the autodoc, all the above lines of code will be skipped.
If possible, change your code so that
ifdefdoesn't wrap any lines of codes.
#ifdef MY_DEFINE #define MY_DEFINE 10 #endif ... Lines of code
MY_DEFINEis defined in another file
my_other_file.hadd it to the
INPUTkey (so it can be read in the autodoc stage) and to
excludeAPI(to exclude it from being documented)
autodocSettings PublicAPI ... INPUT: 'my_file.h my_other_file.h' excludeApi: [my_other_file.h] ENABLE_PREPROCESSING: 'YES' #default value for C/C++
PREDEFINEDkey to add the definition of to define
MY_DEFINEfor the autodoc stage.
autodocSettings PublicAPI ... INPUT: 'my_file.h' excludeApi:  #default value for C/C++ ENABLE_PREPROCESSING: 'YES' #default value for C/C++ PREDEFINED: - MY_DEFINE=10
ENABLE_PREPROCESSINGto stop doxygen from evaluating any C-preprocessor directives.
autodocSettings PublicAPI ... INPUT: 'my_file.h' excludeApi:  #default value for C/C++ ENABLE_PREPROCESSING: 'NO' PREDEFINED:'' #default value for C/C++
Add a shield icon
Shield icon links are quite popular in github repositories.
If you want to add a docs shield to your repo:
Add the following code snippet: