Customization

This section describes a recommended approach to customizing DocBrowser that should alleviate issues down the track if a new version is released and you need to merge it with your changes.

Layout File

The layout file is where you'll make most changes to make DocBrowser suit your needs. These edits are unavoidable and in future releases of DocBrowsers I'll document any changes required to the layout so you can manually make the same edits to your layout file.

StyleSheets and Scripts

Unless absolutely necessary I don't recommend editing the .css and .js files in the /docbrowser folder.

For styling changes I suggest you create your own file db-customize.css that contains all your styling changes and include it after the supplied css files:

    <link rel="stylesheet" href="/docbrowser/db-layout.css" />
    <link rel="stylesheet" href="/docbrowser/db-appearance.css" />
    <link rel="stylesheet" href="/db-customize.css" />
    <script src="/docbrowser/db-script.js"></script>

Similarly for scripting changes, if you can keep your scripting separate from DocBrowsers you'll simplify things when moving to a new version.

That said, script changes may be difficult to keep separate it might be necessary to edit db-script.js directly. The best suggestion I have for this is to comment those changes so you can identify and merge changes at a later date if necessary.