Skip to content

DocFX template used by Singulink projects. Fully responsive and designed to be familiar to those used to browsing Microsoft .NET documentation.

License

Notifications You must be signed in to change notification settings

Singulink/SingulinkFX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 

Repository files navigation

SingulinkFX

Chat on Discord

SingulinkFX is a fully responsive DocFX template used for Singulink projects to produce documentation that is familiar to those used to browsing Microsoft's .NET documentation.

Features:

  • Responsive layout for all device sizes.
  • Easily configurable colors and sidebar width.
  • Empty table columns are removed, so if you don't comment the parameters or return value on some methods then it won't display an empty description column.
  • The table of contents supports 4 levels of items to properly facilitate usage together with the separatePages member layout.
  • Contains optional style overrides optimized for displaying articles.
  • Includes Bootstrap Icons.

Method Page Screenshot

About Singulink

We are a small team of engineers and designers dedicated to building beautiful, functional and well-engineered software solutions. We offer very competitive rates as well as fixed-price contracts and welcome inquiries to discuss any custom development / project support needs you may have.

Visit https://github.com/Singulink to see our full list of publicly available libraries and other open-source projects.

Installation

  1. Download the source or the zipped file from the releases page.
  2. In your DocFX project folder, create a directory named templates, if it doesn't already exist.
  3. Copy the singulinkfx folder from this repository into the templates folder.
  4. In your docfx.json configuration file, add the singulinkfx path into the build.template property:
    "template": ["default", "templates/singulinkfx"]

A real-world example of a .NET library using this template with articles can be found in the Singulink.IO.FileSystem repository (check out the Docs folder). If you are new to DocFX you might also find it helpful for properly setting up the table of contents.

Versions and Upgrading

Version 3.x

For use with DocFX v2.75 and above.

Version 2.x

For use with DocFX v2.62 and above.

The memberpage-extras plugin has been removed for version 2+ of the template. DocFX v2.62 no longer shows explicit interface members by default. Furthermore, the functionality to group explicit interface implementations into their own section in the table of contents has been merged into the DocFX codebase and an option for including explicit interface implementations is in the works so the plugin should no longer be necessary moving forward.

Version 1.x

For DocFX versions older than v2.62 you should use v1.1 of this template.

Customization

Configuration

The following is a sample docfx.json global metadata section that demonstrates the usage of the options this theme offers:

"globalMetadata": {
    "_appTitle": "Singulink.IO.FileSystem",
    "_appName": "File System",
    "_appFaviconPath": "images/favicon.png",
    "_appLogoPath": "images/logo.png",
    "_appFooter": "<strong>DocFX + Singulink = ♥</strong>",
    "_copyrightFooter": "© Singulink. All rights reserved.",
    "_enableSearch": true,
    "_disableSideFilter": false,
    "_enableNewTab": true,
    "_disableContribution": false,
    "_disableBreadcrumb": false,
}

Configuration Areas

Colors and Layout

You can change any color as well as the width of the side bar and font sizes for desktop and mobile views. The values are defined in the styles/config.css file. The recommended approach to changing the default values is to create another directory inside templates for your sub-theme that overrides these values in a styles/main.css file, and add your theme to the end of the list of templates in docfx.json. Your main.css file will be automatically referenced in the output, there is no need to override any other template files.

Custom Javascript

The styles/main.js file can be used to add your own custom Javascript. The recommended approach is to create another directory inside templates for your sub-theme, add a styles/main.js file, and add your theme to the end of the list of templates in docfx.json. Your main.js file will be automatically referenced in the output, there is no need to override any other template files.

Article Styling

Wrap your HTML or markdown in a <div class="article"></div> to activate styles that change heading styles and spacing to something more suitable for articles instead of API member docs. Supports up to 5 heading levels (h1 to h5 for HTML or # to ##### for markdown).

More Screenshots

Desktop

Article Screenshot

Namespace Page Screenshot

Class Page Screenshot

Mobile

Class Mobile Page Screenshot

Nav Menu Mobile Screenshot

Attribution

Special thanks to @jbltx for creating DiscordFX which was a great starting point for this template.

About

DocFX template used by Singulink projects. Fully responsive and designed to be familiar to those used to browsing Microsoft .NET documentation.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published