How to get ride of a empty page when using Doxygen to generate markdown user documentationHow to remove files tab from html file generated by doxygen?Objective-C Documentation Generators: HeaderDoc vs. Doxygen vs. AppleDocdoxygen copy specific data from doxygen comments into markdown pageHow to enable markdown support in Doxygen and keep original file extensions?How to use Markdown pages and Doxygen groups?Doxygen Conditional Markdown PagesHow to use doxygen to create documentation for my config file in my project repository on Windows?Doxygen generation stops at 'Searching for documented variables…'How to define an image which is a link in markdown so it will be parsed by doxygenHow do I get rid of the empty related pages tab in doxygen?
How to make thick Asian sauces?
Is the decompression of compressed and encrypted data without decryption also theoretically impossible?
Count down from 0 to 5 seconds and repeat
Can a magnetic field of an object be stronger than its gravity?
How could a possessed body begin to rot and decay while it is still alive?
What happens to foam insulation board after you pour concrete slab?
What do we gain with higher order logics?
Is it OK to bring delicacies from hometown as tokens of gratitude for an out-of-town interview?
Short story written from alien perspective with this line: "It's too bright to look at, so they don't"
Metal bar on DMM PCB
Can you please explain this joke: "I'm going bananas is what I tell my bananas before I leave the house"?
Shrink exponential fraction argument
Diet Coke or water?
What does it mean by "d-ism of Leibniz" and "dotage of Newton" in simple English?
What is a simple, physical situation where complex numbers emerge naturally?
Regarding eBGP Multipath
Pros and cons of writing a book review?
How to decline physical affection from a child whose parents are pressuring them?
Old black and white movie: glowing black rocks slowly turn you into stone upon touch
Traffic law UK, pedestrians
What flavor of zksnark in tezos
Why is the relationship between frequency and pitch exponential?
Replace only 2nd, 3rd, nth...character and onwards
What was the point of getting this item into the Quantum Tunnel?
How to get ride of a empty page when using Doxygen to generate markdown user documentation
How to remove files tab from html file generated by doxygen?Objective-C Documentation Generators: HeaderDoc vs. Doxygen vs. AppleDocdoxygen copy specific data from doxygen comments into markdown pageHow to enable markdown support in Doxygen and keep original file extensions?How to use Markdown pages and Doxygen groups?Doxygen Conditional Markdown PagesHow to use doxygen to create documentation for my config file in my project repository on Windows?Doxygen generation stops at 'Searching for documented variables…'How to define an image which is a link in markdown so it will be parsed by doxygenHow do I get rid of the empty related pages tab in doxygen?
.everyoneloves__top-leaderboard:empty,.everyoneloves__mid-leaderboard:empty,.everyoneloves__bot-mid-leaderboard:empty height:90px;width:728px;box-sizing:border-box;
Currently I am using Doxygen to generate a user document from a few markdown files.
I want to generate a custom navigation tree like the following:
- Install
- --Install on macos
- --Install on windows
- --Install on linux
And I have 4 markdown pages, here. let's say they are "install.md", "macos.md", "windows.md" and "linux.md".
My install.md file is as follow:
- @page install
- @subpage macos
- @subpage windows
- @subpage linux
and the "macos.md" , "windows.md" and "linux.md" each has its own page title:
such as @page macos , @page windows and @page linux.
The result is very good, but it generate a few empty pages with the file name.
How could I get rid of all these empty page files?
Thanks in advance.
doxygen
asked Apr 13 '14 at 16:12
0owen0owen
163
add a comment |
Currently I am using Doxygen to generate a user document from a few markdown files.
I want to generate a custom navigation tree like the following:
- Install
- --Install on macos
- --Install on windows
- --Install on linux
And I have 4 markdown pages, here. let's say they are "install.md", "macos.md", "windows.md" and "linux.md".
My install.md file is as follow:
- @page install
- @subpage macos
- @subpage windows
- @subpage linux
and the "macos.md" , "windows.md" and "linux.md" each has its own page title:
such as @page macos , @page windows and @page linux.
The result is very good, but it generate a few empty pages with the file name.
How could I get rid of all these empty page files?
Thanks in advance.
doxygen
asked Apr 13 '14 at 16:12
0owen0owen
163
add a comment |
Currently I am using Doxygen to generate a user document from a few markdown files.
I want to generate a custom navigation tree like the following:
- Install
- --Install on macos
- --Install on windows
- --Install on linux
And I have 4 markdown pages, here. let's say they are "install.md", "macos.md", "windows.md" and "linux.md".
My install.md file is as follow:
- @page install
- @subpage macos
- @subpage windows
- @subpage linux
and the "macos.md" , "windows.md" and "linux.md" each has its own page title:
such as @page macos , @page windows and @page linux.
The result is very good, but it generate a few empty pages with the file name.
How could I get rid of all these empty page files?
Thanks in advance.
doxygen
asked Apr 13 '14 at 16:12
0owen0owen
163
Currently I am using Doxygen to generate a user document from a few markdown files.
I want to generate a custom navigation tree like the following:
- Install
- --Install on macos
- --Install on windows
- --Install on linux
And I have 4 markdown pages, here. let's say they are "install.md", "macos.md", "windows.md" and "linux.md".
My install.md file is as follow:
- @page install
- @subpage macos
- @subpage windows
- @subpage linux
and the "macos.md" , "windows.md" and "linux.md" each has its own page title:
such as @page macos , @page windows and @page linux.
The result is very good, but it generate a few empty pages with the file name.
How could I get rid of all these empty page files?
Thanks in advance.
doxygen
doxygen
asked Apr 13 '14 at 16:12
0owen0owen
163
asked Apr 13 '14 at 16:12
0owen0owen
163
asked Apr 13 '14 at 16:12
0owen0owen
163
asked Apr 13 '14 at 16:12
0owen0owen
163
asked Apr 13 '14 at 16:12
0owen0owen
163
163
add a comment |
add a comment |
2 Answers
2
active
oldest
votes
I looked for ages for a decent solution, and this is what i found:
In your main markdown file (here install.md), define a group, such as:
defgroup GrpDummyPages HiddenEmpty
@
@
Then in your subpages, for intance your 'windows.md', add at the beginning:
ingroup GrpDummyPages
In your tree view will appeaer a 'modules' section, with sub-category 'HiddenEmpty', which will contain the pages/files where you put the ingroup command.
answered Aug 19 '15 at 15:06
NapseisNapseis
3931517
add a comment |
With doxygen 1.8.10, this seems to work: Use the Header ID Attributes #pageId Marker after a Headline in the .md files exclusively.
Doxygen doc for that: http://www.doxygen.nl/manual/markdown.html#md_header_id
Using @page works, but it will create the additional empty page in the navigation tree.
An example... Assuming a little hierarchy:
Main.md
SubPage1 (Subfolder)
SubPage1.md (File in Subfolder)
Main.md:
# Main Page #mainpage
This is text...
* subpage SubPage1
SubPage1.md:
# First Subpage Title #SubPage1
Some text for the subpage
The hierarchy will be represented in the generated TreeView, you can nest pages as you like..
The following demonstrates the problem .. it will create the additional empty page ...
SubPage1.md: (Buggy)
@page SubPage1
# First Subpage Title
Some text for the subpage
edited Mar 24 at 13:20
albert
3,25231125
answered Sep 16 '15 at 5:31
Louis CyphreLouis Cyphre
12
hi. For me this also places a page in the left tree with name SubPage1.
– Napseis
Sep 16 '15 at 10:41
@Napseis ... I am sorry to hear that. Did you use Doxygen 1.8.10 (latest Version at this time)?
– Louis Cyphre
Sep 17 '15 at 5:43
I have Doxygen 1.8.9.1
– Napseis
Sep 18 '15 at 14:49
Basically, if the page is not a @Subpage of something else, it will appear in the index.
– Louis Cyphre
Oct 10 '15 at 11:44
add a comment |
Your Answer
StackExchange.ifUsing("editor", function ()
StackExchange.using("externalEditor", function ()
StackExchange.using("snippets", function ()
StackExchange.snippets.init();
);
);
, "code-snippets");
StackExchange.ready(function()
var channelOptions =
tags: "".split(" "),
id: "1"
;
initTagRenderer("".split(" "), "".split(" "), channelOptions);
StackExchange.using("externalEditor", function()
// Have to fire editor after snippets, if snippets enabled
if (StackExchange.settings.snippets.snippetsEnabled)
StackExchange.using("snippets", function()
createEditor();
);
else
createEditor();
);
function createEditor()
StackExchange.prepareEditor(
heartbeatType: 'answer',
autoActivateHeartbeat: false,
convertImagesToLinks: true,
noModals: true,
showLowRepImageUploadWarning: true,
reputationToPostImages: 10,
bindNavPrevention: true,
postfix: "",
imageUploader:
brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
allowUrls: true
,
onDemand: true,
discardSelector: ".discard-answer"
,immediatelyShowMarkdownHelp:true
);
);
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f23045065%2fhow-to-get-ride-of-a-empty-page-when-using-doxygen-to-generate-markdown-user-doc%23new-answer', 'question_page');
);
Post as a guest
Required, but never shown
2 Answers
2
active
oldest
votes
2 Answers
2
active
oldest
votes
active
oldest
votes
active
oldest
votes
I looked for ages for a decent solution, and this is what i found:
In your main markdown file (here install.md), define a group, such as:
defgroup GrpDummyPages HiddenEmpty
@
@
Then in your subpages, for intance your 'windows.md', add at the beginning:
ingroup GrpDummyPages
In your tree view will appeaer a 'modules' section, with sub-category 'HiddenEmpty', which will contain the pages/files where you put the ingroup command.
answered Aug 19 '15 at 15:06
NapseisNapseis
3931517
add a comment |
I looked for ages for a decent solution, and this is what i found:
In your main markdown file (here install.md), define a group, such as:
defgroup GrpDummyPages HiddenEmpty
@
@
Then in your subpages, for intance your 'windows.md', add at the beginning:
ingroup GrpDummyPages
In your tree view will appeaer a 'modules' section, with sub-category 'HiddenEmpty', which will contain the pages/files where you put the ingroup command.
answered Aug 19 '15 at 15:06
NapseisNapseis
3931517
add a comment |
I looked for ages for a decent solution, and this is what i found:
In your main markdown file (here install.md), define a group, such as:
defgroup GrpDummyPages HiddenEmpty
@
@
Then in your subpages, for intance your 'windows.md', add at the beginning:
ingroup GrpDummyPages
In your tree view will appeaer a 'modules' section, with sub-category 'HiddenEmpty', which will contain the pages/files where you put the ingroup command.
answered Aug 19 '15 at 15:06
NapseisNapseis
3931517
I looked for ages for a decent solution, and this is what i found:
In your main markdown file (here install.md), define a group, such as:
defgroup GrpDummyPages HiddenEmpty
@
@
Then in your subpages, for intance your 'windows.md', add at the beginning:
ingroup GrpDummyPages
In your tree view will appeaer a 'modules' section, with sub-category 'HiddenEmpty', which will contain the pages/files where you put the ingroup command.
answered Aug 19 '15 at 15:06
NapseisNapseis
3931517
answered Aug 19 '15 at 15:06
NapseisNapseis
3931517
answered Aug 19 '15 at 15:06
NapseisNapseis
3931517
answered Aug 19 '15 at 15:06
NapseisNapseis
3931517
3931517
add a comment |
add a comment |
With doxygen 1.8.10, this seems to work: Use the Header ID Attributes #pageId Marker after a Headline in the .md files exclusively.
Doxygen doc for that: http://www.doxygen.nl/manual/markdown.html#md_header_id
Using @page works, but it will create the additional empty page in the navigation tree.
An example... Assuming a little hierarchy:
Main.md
SubPage1 (Subfolder)
SubPage1.md (File in Subfolder)
Main.md:
# Main Page #mainpage
This is text...
* subpage SubPage1
SubPage1.md:
# First Subpage Title #SubPage1
Some text for the subpage
The hierarchy will be represented in the generated TreeView, you can nest pages as you like..
The following demonstrates the problem .. it will create the additional empty page ...
SubPage1.md: (Buggy)
@page SubPage1
# First Subpage Title
Some text for the subpage
edited Mar 24 at 13:20
albert
3,25231125
answered Sep 16 '15 at 5:31
Louis CyphreLouis Cyphre
12
hi. For me this also places a page in the left tree with name SubPage1.
– Napseis
Sep 16 '15 at 10:41
@Napseis ... I am sorry to hear that. Did you use Doxygen 1.8.10 (latest Version at this time)?
– Louis Cyphre
Sep 17 '15 at 5:43
I have Doxygen 1.8.9.1
– Napseis
Sep 18 '15 at 14:49
Basically, if the page is not a @Subpage of something else, it will appear in the index.
– Louis Cyphre
Oct 10 '15 at 11:44
add a comment |
With doxygen 1.8.10, this seems to work: Use the Header ID Attributes #pageId Marker after a Headline in the .md files exclusively.
Doxygen doc for that: http://www.doxygen.nl/manual/markdown.html#md_header_id
Using @page works, but it will create the additional empty page in the navigation tree.
An example... Assuming a little hierarchy:
Main.md
SubPage1 (Subfolder)
SubPage1.md (File in Subfolder)
Main.md:
# Main Page #mainpage
This is text...
* subpage SubPage1
SubPage1.md:
# First Subpage Title #SubPage1
Some text for the subpage
The hierarchy will be represented in the generated TreeView, you can nest pages as you like..
The following demonstrates the problem .. it will create the additional empty page ...
SubPage1.md: (Buggy)
@page SubPage1
# First Subpage Title
Some text for the subpage
edited Mar 24 at 13:20
albert
3,25231125
answered Sep 16 '15 at 5:31
Louis CyphreLouis Cyphre
12
hi. For me this also places a page in the left tree with name SubPage1.
– Napseis
Sep 16 '15 at 10:41
@Napseis ... I am sorry to hear that. Did you use Doxygen 1.8.10 (latest Version at this time)?
– Louis Cyphre
Sep 17 '15 at 5:43
I have Doxygen 1.8.9.1
– Napseis
Sep 18 '15 at 14:49
Basically, if the page is not a @Subpage of something else, it will appear in the index.
– Louis Cyphre
Oct 10 '15 at 11:44
add a comment |
With doxygen 1.8.10, this seems to work: Use the Header ID Attributes #pageId Marker after a Headline in the .md files exclusively.
Doxygen doc for that: http://www.doxygen.nl/manual/markdown.html#md_header_id
Using @page works, but it will create the additional empty page in the navigation tree.
An example... Assuming a little hierarchy:
Main.md
SubPage1 (Subfolder)
SubPage1.md (File in Subfolder)
Main.md:
# Main Page #mainpage
This is text...
* subpage SubPage1
SubPage1.md:
# First Subpage Title #SubPage1
Some text for the subpage
The hierarchy will be represented in the generated TreeView, you can nest pages as you like..
The following demonstrates the problem .. it will create the additional empty page ...
SubPage1.md: (Buggy)
@page SubPage1
# First Subpage Title
Some text for the subpage
edited Mar 24 at 13:20
albert
3,25231125
answered Sep 16 '15 at 5:31
Louis CyphreLouis Cyphre
12
With doxygen 1.8.10, this seems to work: Use the Header ID Attributes #pageId Marker after a Headline in the .md files exclusively.
Doxygen doc for that: http://www.doxygen.nl/manual/markdown.html#md_header_id
Using @page works, but it will create the additional empty page in the navigation tree.
An example... Assuming a little hierarchy:
Main.md
SubPage1 (Subfolder)
SubPage1.md (File in Subfolder)
Main.md:
# Main Page #mainpage
This is text...
* subpage SubPage1
SubPage1.md:
# First Subpage Title #SubPage1
Some text for the subpage
The hierarchy will be represented in the generated TreeView, you can nest pages as you like..
The following demonstrates the problem .. it will create the additional empty page ...
SubPage1.md: (Buggy)
@page SubPage1
# First Subpage Title
Some text for the subpage
edited Mar 24 at 13:20
albert
3,25231125
answered Sep 16 '15 at 5:31
Louis CyphreLouis Cyphre
12
edited Mar 24 at 13:20
albert
3,25231125
edited Mar 24 at 13:20
albert
3,25231125
edited Mar 24 at 13:20
albert
3,25231125
3,25231125
answered Sep 16 '15 at 5:31
Louis CyphreLouis Cyphre
12
answered Sep 16 '15 at 5:31
Louis CyphreLouis Cyphre
12
answered Sep 16 '15 at 5:31
Louis CyphreLouis Cyphre
12
12
hi. For me this also places a page in the left tree with name SubPage1.
– Napseis
Sep 16 '15 at 10:41
@Napseis ... I am sorry to hear that. Did you use Doxygen 1.8.10 (latest Version at this time)?
– Louis Cyphre
Sep 17 '15 at 5:43
I have Doxygen 1.8.9.1
– Napseis
Sep 18 '15 at 14:49
Basically, if the page is not a @Subpage of something else, it will appear in the index.
– Louis Cyphre
Oct 10 '15 at 11:44
add a comment |
hi. For me this also places a page in the left tree with name SubPage1.
– Napseis
Sep 16 '15 at 10:41
@Napseis ... I am sorry to hear that. Did you use Doxygen 1.8.10 (latest Version at this time)?
– Louis Cyphre
Sep 17 '15 at 5:43
I have Doxygen 1.8.9.1
– Napseis
Sep 18 '15 at 14:49
Basically, if the page is not a @Subpage of something else, it will appear in the index.
– Louis Cyphre
Oct 10 '15 at 11:44
hi. For me this also places a page in the left tree with name SubPage1.
– Napseis
Sep 16 '15 at 10:41
hi. For me this also places a page in the left tree with name SubPage1.
– Napseis
Sep 16 '15 at 10:41
@Napseis ... I am sorry to hear that. Did you use Doxygen 1.8.10 (latest Version at this time)?
– Louis Cyphre
Sep 17 '15 at 5:43
@Napseis ... I am sorry to hear that. Did you use Doxygen 1.8.10 (latest Version at this time)?
– Louis Cyphre
Sep 17 '15 at 5:43
I have Doxygen 1.8.9.1
– Napseis
Sep 18 '15 at 14:49
I have Doxygen 1.8.9.1
– Napseis
Sep 18 '15 at 14:49
Basically, if the page is not a @Subpage of something else, it will appear in the index.
– Louis Cyphre
Oct 10 '15 at 11:44
Basically, if the page is not a @Subpage of something else, it will appear in the index.
– Louis Cyphre
Oct 10 '15 at 11:44
add a comment |
Thanks for contributing an answer to Stack Overflow!
- Please be sure to answer the question. Provide details and share your research!
But avoid …
- Asking for help, clarification, or responding to other answers.
- Making statements based on opinion; back them up with references or personal experience.
To learn more, see our tips on writing great answers.
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
StackExchange.ready(
function ()
StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2fstackoverflow.com%2fquestions%2f23045065%2fhow-to-get-ride-of-a-empty-page-when-using-doxygen-to-generate-markdown-user-doc%23new-answer', 'question_page');
);
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function ()
StackExchange.helpers.onClickDraftSave('#login-link');
);
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
Required, but never shown
