Adding style and fixed menu

_static/css/style.css

@@ -0,0 +1,201 @@
+@import url("https://fonts.googleapis.com/css?family=Open+Sans");
+
+@import url("https://maxcdn.bootstrapcdn.com/font-awesome/4.6.1/css/font-awesome.min.css");
+
+body {
+	color: #333;
+
+	font-family: 'Open Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif !important;
+	font-size: 14px;
+}
+
+h1, h2, h3, h4, h5, h6 {
+	font-family: 'Open Sans', 'Helvetica Neue', Helvetica, Arial, sans-serif;
+    font-weight: 600;
+}
+
+/**
+ * Anchors
+ */
+a,
+a:visited {
+	color: #16a2c5;
+
+	text-decoration: none;
+}
+
+a:hover,
+a:focus {
+	color: #0e6980;
+
+	text-decoration: underline;
+}
+
+a.icon-home,
+a.icon-home:hover {
+	background: url("https://www.simplifier.net/images/simplifier-logo.png") no-repeat;
+	background-size: contain;
+
+	margin-bottom: 0;
+
+	text-indent: 9999px;
+}
+
+/**
+ * Body
+ */
+ p {
+	font-size: 14px;
+}
+
+.wy-nav-content {
+	background: #fff;
+}
+
+.wy-body-for-nav {
+	background-image: none;
+}
+
+.wy-nav-content-wrap {
+	background: #fff;
+}
+
+.wy-menu-vertical a {
+	font-size: 14px;
+	color: #16a2c5;
+}
+
+.wy-menu-vertical a:hover, a:focus {
+	color: #0e6980;
+
+}
+.wy-nav-content {
+	max-width: 800px;
+	width: 100%;
+
+	word-wrap: break-word;
+}
+
+.wy-nav-side,
+.wy-menu-vertical a:hover {
+	background: #ededed !important;
+}
+
+.wy-side-nav-search {
+	background-color: #ededed;
+
+	border-bottom: 2px solid #e5c630;
+}
+
+.wy-side-nav-search input[type=text] {
+	border-radius: 0px;
+	border-color: #ccc;
+
+	font-size: 14px;
+
+	height: 36px;
+
+	padding: 7px 14px;
+}
+
+.wy-breadcrumbs-api {
+	height: 50px;
+}
+
+/**
+ * Buttons
+ */
+.btn {
+	box-shadow: none;
+
+	display: inline-block;
+
+	font-weight: 600;
+
+	margin-bottom: 0;
+}
+
+.btn-neutral,
+.btn-neutral:visited {
+	background-color: #16a2c5 !important;
+
+	border-color: none;
+
+	color: #fff !important;
+
+	text-decoration: none;
+}
+
+.btn-neutral:hover {
+	background-color: #117c97 !important;
+
+	border-color: #0d6277;
+
+	color: #fff;
+
+	text-decoration: none;
+}
+
+a.btn span.fa {
+	display: none;
+}
+
+div.wy-menu.rst-pro {
+	display: none !important;
+	visibility: hidden;
+}
+
+.wy-menu-vertical li.current {
+	background: #ededed;
+}
+
+.wy-menu-vertical li.current a {
+	border-right: 0px;
+}
+
+.wy-menu-vertical li.current > a {
+	background: none;
+
+	color: grey;
+
+	border-top: 0px;
+	border-bottom: 0px;
+}
+
+.wy-menu-vertical li.toctree-l2 a:hover {
+	background: #d9d9d9 !important;
+}
+
+.wy-menu-vertical li.toctree-l3 > a:hover {
+	background: #ededed !important;
+}
+
+.rst-versions {
+	background: #EDEDED;
+
+	border-top: solid 10px #EDEDED;
+}
+
+.rst-versions .rst-other-versions dd a {
+	color: #16a2c5;
+
+	padding: 6px 6px 6px 0;
+}
+
+.rst-versions .rst-current-version {
+	background-color: #7C7C7D;
+
+	color: #fff !important;
+}
+
+.rst-versions .rst-other-versions {
+	color: #333;
+}
+
+.rst-versions .rst-other-versions hr {
+	display: none;
+}
+
+.injected dd div {
+	padding: 6px 6px 6px 0 !important;
+}

_templates/breadcrumbs.html

@@ -0,0 +1,54 @@
+{% extends "!breadcrumbs.html" %}
+
+{% block breadcrumbs %}
+
+  <div><a href="https://www.devdays.com"><img src="{{ pathto('_static/images/banner.png', 1) }}" alt="FHIR DevDays banner"/></a></div>
+  <hr/>
+	{% if _('firelynetsdk') in pagename %}
+		<li class="wy-breadcrumbs-api"><a href="{{ pathto(master_doc) }}">{{ _('Docs') }}</a> &raquo;</li>
+	{% else %}
+		<li><a href="{{ pathto(master_doc) }}">{{ _('Docs') }}</a> &raquo;</li>
+	{% endif %}
+	{% for doc in parents %}
+		{% if loop.index == 1 %}
+			{% if _('simplifier') in pagename %}
+				<li><a href="{{ doc.link|e }}">Simplifier</a> &raquo;</li>
+			{% elif _('forge') in pagename %}
+				<li><a href="{{ doc.link|e }}">Forge</a> &raquo;</li>
+			{% elif _('vonk') in pagename %}
+				<li><a href="{{ doc.link|e }}">Vonk</a> &raquo;</li>
+			{% elif _('firelynetsdk') in pagename %}
+				<li><a href="{{ doc.link|e }}">SDK</a> &raquo;</li>
+			{% elif _('firelyterminal') in pagename %}
+				<li><a href="{{ doc.link|e }}">Firely Terminal</a> &raquo;</li>
+			{% elif _('mappingengine') in pagename %}
+				<li><a href="{{ doc.link|e }}">FHIR Mapper</a> &raquo;</li>
+			{% elif _('vonkloader') in pagename %}
+				<li><a href="{{ doc.link|e }}">VonkLoader</a> &raquo;</li>
+			{% endif %}
+		{% else %}
+			<li><a href="{{ doc.link|e }}">{{ doc.title }}</a> &raquo;</li>
+		{% endif %}
+	{% endfor %}
+    <li>{{ title }}</li>
+{% endblock %}
+
+<!-- Add navigation to GitHub for Firely .Net SDK docs, and include Azure DevOps status -->
+{% block breadcrumbs_aside %}
+	{% if hasdoc(pagename) %}
+		{% if _('firelynetsdk') in pagename %}
+			<li class="wy-breadcrumbs-aside">
+				<div class="wy-control-no-input">
+					STU3: <a href="https://dev.azure.com/firely/firely-net-sdk/_build?view=buildsHistory&definitionId=14"><img src="https://dev.azure.com/firely/firely-net-sdk/_apis/build/status/Continuous%20Build?branchName=develop-stu3"/></a>
+					R4: <a href="https://dev.azure.com/firely/firely-net-sdk/_build?view=buildsHistory&definitionId=14"><img src="https://dev.azure.com/firely/firely-net-sdk/_apis/build/status/Continuous%20Build?branchName=develop-r4"/></a></br>
+					<a href="https://github.com/FirelyTeam/firely-net-sdk">
+						<svg version="1.1" width="12" height="12" viewBox="0 0 16 16" class="octicon octicon-mark-github" aria-hidden="true">
+							<path fill-rule="evenodd" d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0 0 16 8c0-4.42-3.58-8-8-8z"/>
+						</svg>
+						 View source on GitHub
+					</a>
+				</div>
+			</li>
+		{% endif %}
+	{% endif %}
+{% endblock %}

_templates/layout.html

@@ -0,0 +1,4 @@
+{% extends "!layout.html" %}
+
+<!-- Use Simplifier styling -->
+{% set css_files = css_files + [ "_static/css/style.css" ] %}

api.rst

@@ -0,0 +1,8 @@
+==============================
+A Simplifier docs page on APIs
+==============================
+
+This is a specific page on APIs in the Simplifier docs
+
+This is a link to the general Firely API page:
+:doc:`main_docs:api`

build.bat

@@ -0,0 +1 @@
+sphinx-build -b html . .\_build\html

conf.py

@@ -21,15 +21,22 @@
 copyright = '2021, Firely'
 author = 'Firely'
 
+master_doc = 'index'
+html_theme_options = {'navigation_depth': 3}
 
 # -- General configuration ---------------------------------------------------
 
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    'sphinx.ext.intersphinx',
 ]
 
+intersphinx_mapping = {
+    'main_docs': ('https://firely-docs-main.readthedocs.io/en/latest', None),
+    }
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 
@@ -44,7 +51,8 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = 'alabaster'
+# html_theme = 'alabaster'
+html_theme = 'sphinx_rtd_theme'
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,

index.rst

@@ -3,18 +3,20 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-Welcome to Firely Simplifier Docs's documentation!
-==================================================
+Welcome to Firely Simplifier's documentation!
+================================================
 
 .. toctree::
    :maxdepth: 2
-   :caption: Contents:
-
+   :caption: Simplifier Docs:
+
+   api
 
+.. toctree::
+   :maxdepth: 2
+   :caption: Projects
 
-Indices and tables
-==================
+   General Firely Docs <https://firely-docs-main.readthedocs.io>
+   Simplifier Docs <https://firely-docs-main.readthedocs.io/projects/Simplifier/en/latest>
 
-* :ref:`genindex`
-* :ref:`modindex`
-* :ref:`search`
+.. Too bad Intersphinx doesn't work in the toctree