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.
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
files in the
For styling changes I suggest you create your own file
that contains all your styling changes and include it after the supplied
<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.