Hi, thanks for you work on this nice tool. I sometimes need to embed images in my documentation, so I use ![](https://avatars1.githubusercontent.com/u/3950390?s=140) in my markdown file and it renders like

In Github READMEs it is also possible to use a relative URL for images (eg ![](images/schema.png) or ![](screenshot.png), whereas daux.io displays nothing when I use a relative path.

How is it possible to display images living in the same directory as the docs?

Patch to temporarily correct unassigned "entry_page" value when a sub-folder only contains a single index.

Preliminary sort on build tree to improve first_page identification.

Need testing on "View Documentation" assignment when only nested index pages are available. Currently fails with invalid URI.

For the life of me I can't figure out how to enable the markdown editor.

I tried adding { "file_editor": true, } to config.json but nothing happens once I compile the static page.

The Code Highlighting page falls apart on Firefox 22 ("Mozilla/5.0 (Windows NT 6.1; WOW64; rv:22.0) Gecko/20100101 Firefox/22.0"). It's good on 1145, and broken on 1150 (as given by document.documentElement.clientWidth).

Hi @justinwalsh,

I tried to contact you about this but got no answer from you.

Can we move daux.io to an organization ? I created one and invited you to it : https://github.com/dauxio

Also, the development/production sites don't update anymore on push. Is it possible for me to take the domain and move the site to my servers ?

Thanks in advance

Is their a way to add an optional simple login system to this documentation web app? I would love to use this for my company web app documentation, however, it has some sensitive information that I need to keep secure. Thanks for your suggestions.

Hi,

I know this is a big pull request, but I needed all these functionnalities at the same time and could not make a lot of small pull requests. I will explain what I did in details here.

General

• PSR-2 Coding style is now PSR-2, this eases the collaboration between projects
• PHP 5.4 is a minimum, it makes the code more readable in some places. and PHP 5.3 is unsupported for a long time now

Code Structure

• Uses PSR-4 Standard, easier autoloading.
• Separated "Generator" and "Server" make a much clearer code.
• Also separated "Tree" to generate the structure.

Features

• Abstract generation system, be able to choose how to generate the documentation
• Added Atlassian Confluence upload support (with image attachments and code highlight)
• Replaced Parsedown by CommonMark
• Added internal links
• Extend Daux with "Processors" a class to change the tree and generate new pages on the fly
• The project is packaged as phar archive. allowing to run easily without requiring dozens of files. easy to commit with the documented project.

Documentation structure

• Images are now directly in the docs folder, make a more contained documentation : generator/server on one side, documentation on the other
• resources folder contains js files, themes and img. makes it easier to configure the copy on generation.

Templates

• Templates are now generated with http://platesphp.com/
• Templates are much cleaner and overridable by creating a templates folder inside the theme and naming the template the same way as the original one. the engine does the rest.

Bugfixes

• in generated mode, the name of the documentation links to index instead of index.html
• if there are no links, the documentation doesn't show the "show/hide code blocks" toggle
• a _index.md page in a sub folder now uses the default template and not the one for homepages.
• Page.md is exactly the same as Page/_index.md, the index Page calculation takes it in account.

Don't hesitate if you want me to fix/change something before you accept the pull request.

I downloaded daux.io-master and ran "npm install" followed by "grunt" without changing any of the default settings or content. The site shows up correctly in Chrome but expand/collapse links such as "Examples" and "More Examples" don't work in IE and there is no style at all in Firefox.

Viewing the source, I see links like this:

<link href='//127.0.0.1:8085/templates/default/themes/daux-blue/css/daux-blue.css' rel='stylesheet' type='text/css'>

I don't know why there's a backslash after the port number, but that almost certainly is the cause of the problem. (All three browsers show this in the source, but they have mixed results in handling it.)

My environment: Windows 7 (64-bit) SP1 node.js 0.12.2 php 5.6.0 Firefox 37.0.1

This would be useful if you wanted to deploy to S3, Github Pages, or any static file server.

From reddit user:

This project looked very appealing to me, until I read this part. I am not interested in a service like DocumentUp, I just want to be able to put the generated documentation on our CDN or S3, on our domain. We also have the need for internal docs that we don't want on any public server. I think the solution to this is to add support for optional, purely static export. An external, hosted documentation service will not fit our needs.

Here is the error that I have when trying to access the website:

This site can’t be reached daux.io’s server DNS address could not be found. Search Google for daux io ERR_NAME_NOT_RESOLVED

Hi,

This looks like a very nice documentation generator, but I am trying to remove the right code column, and have the code stay in the main content area.

I am trying this with the provided example docs folder, and I have edited its float attribute to be false. I expected the result to be like this and instead, I still have the right code column. I am viewing this on a wide desktop screen, Chrome on Windows. I can provide a screenshot if needed, but it looks like the screenshot in issue #25