Cleaned up the stylesheets as per csslint. Manually ignore adjoining-classes
to avoid more offenders being added later. Completely ignore order-aphabetical
as it occurs a lot and editing the stylesheet would make git blame less
useful in the future.
The `search.html` template name is a special name (hardcoded) which gets
written to the output if/when the theme includes a seperate search
page. However, the MkDocs theme uses a search modal instead. That does
not belong in a separate file in the output (it is included in `base.html`
template). By renaming the file, we still get the current fucntionality
(easy for users to override/replace the modal) but avoid generating a
broken `search.html` page in the output. Users can still create their own
standalone `search.html` file in the `theme_dir` is they want one, but now
they don't also break the modal when doing so.
An error page can be served from any location and therefore it is
impossable to pre-build an error page with correct relative URLs.
With absolute URLs, the error pages will properly link to other
pages in the nav as well as media files (css, js, images, etc) from
the template regardless of the actual URL the file is served from.
However, to continue to support environments where the docs root is a subdir
of the server root, all other pages must continue to use relative URLs.
The `site_url` is used to determine the server root when building
absolute URLs for the error page to ensure those URLs continue to work
in that type of environment.
Relative URLs are also nessecary for those who browse the site on the
local file system (via `file://`). In that case, the error page will be
broken. However, as error pages are not served by a local file system,
this is no more than a minor inconvience. Error pages should always be
tested from a server environment.
Fixes#77.
The mkdocs theme doesn't need them as the entire page scrolls.
Besides, to get scroll bars on the table, a narrow table won't
strech across the page, which looks wierd with the table styling
used in the mkdocs theme (no borders, etc.).
- Add missing trailing / when printing out GitHub URL. Without the trailing `/` a GitHub error message is shown
- Switched from `http` to `https`, since it's now enabled by default by GitHub
Any template variables which mirrored a config setting have been deprecated
and should be accessed via the coresponding config template variable.
This resolves the rest of #874.
This replicates the recent addition to the ghp_import.py tool (see
https://github.com/davisp/ghp-import/commit/49cfe6e6).
The default is to not force, but if needed (perhaps when deploying
from a CI server), the --force flag can be included.
Fixes#973.
Some scripts need to execute after the page has finished loading.
To ensure that, the `scripts` block is placed at the bottom of the page.
However, if a user embeds scrpts within the body, and those scripts
rely in libs, then the libs need to already be loaded. By having
`libs` be a seperate block at the top of the page (int he header),
we can ensure that will work.
And we still want the libs in a block so a user can override them,
or even add to them (via `{{ super() }}`).
Fixes#956
Previously we only tested that the CLI commands called the approiate function.
Now we also test that the correct options are passed. A few recently
introduced bugs were caught while building these tests (fixed in the
previous couple commits).
Left off tests for the `json` command as it is being deprecated (see #481).
Closes#1016 and #1014.
Raise an error when site_dir is in docs_dir (as opposed to a warning)
and raise an error when docs_dir is the parent dir of the config file.
Fixes#610 and #972.
