mikesmeltzer/dnndocs

The documentation site for the open source Content Management System DNN (formerly DotNetNuke).

DNN Platform Documentation

The documentation site for the open source Content Management System DNN (formerly DotNetNuke).

The project uses the docfx library to pull XML comments from the DNN Platform source code and combine that with articles written in Markdown to form the documentation for DNN.

Installing Git

If you do not have Git installed, you will need to install it first. You can find instructions at Git's Installation Guide.

Installing DocFX

You'll also need DocFX installed as a command-line tool. This can be accomplished using

• Chocolatey for Windows via choco install docfx -y
• Homebrew for macOS via brew install docfx

Alternatively, you can download the latest release of docfx.zip from DocFX's GitHub Releases, extract it to a local directory, and add that directory to PATH so you can run it anywhere.

Setting Up the DNN Docs Project

After installing DocFX, the next step is to clone this repository from GitHub to your local machine. This will create a copy of the DNNDocs Git repository (its directories and folders) on your local machine so that you can work with them there.

The following command will clone this repository to your working directory, so you may wish to cd to an appropriate directory first.

git clone https://github.com/DNNCommunity/DNNDocs.git

The previous command will have created a folder titled DNNDocs in your working directory. So, for example, if you had been working in C:\dev\, the previous command would have created C:\dev\DNNDocs\.

cd DNNDocs

Next, you'll need to clone the Dnn.Platform repository into a subdirectory of DNNDocs so that DocFX can parse its source code for structured XML comments to generate DNN's API documentation and the documentation center articles.

Navigate into the newly created DNNDocs directory and clone the Dnn.Platform. This could take a few minutes depending on your connection speed.

cd DNNDocs
git clone https://github.com/dnnsoftware/Dnn.Platform.git

Running the DNN Docs Project Locally

You should now be able to run the development version of the docs locally with the following command:

docfx --serve

If you installed docfx using Chocolatey for Windows, you will need to run your shell as an administrator.

The compilation process could take quite a while. You may see some warning messages. Eventually, you should see a message similar to:

Serving "C:\dev\DNNDocs\_site" on http://localhost:8080

You can now open http://localhost:8080 in your web browser to view your local DNNDocs app.