Skip to content

Commit 2d53d4a

Browse files
committed
Inline flowchart SVGs
1 parent db82078 commit 2d53d4a

File tree

10 files changed

+54
-78
lines changed

10 files changed

+54
-78
lines changed

docs/_sources/_static/custom.css

Lines changed: 3 additions & 60 deletions
Original file line numberDiff line numberDiff line change
@@ -1,61 +1,4 @@
1-
:root {
2-
--bg-dark: #11303D;
3-
--bg-light: #F0F0F0;
4-
}
5-
6-
html {
7-
background-color: var(--bg-dark, #11303D);
8-
}
9-
10-
body {
11-
background-color: var(--bg-light, #F0F0F0);
12-
}
13-
14-
div.body {
15-
max-width: 100%;
16-
}
17-
div.bodywrapper p {
18-
margin-block: 0;
19-
}
20-
div.bodywrapper section {
21-
background-color: white;
22-
padding: 0 20px 30px 20px;
23-
}
24-
div.bodywrapper section > p {
25-
padding-bottom: 1ex;
26-
}
27-
div.bodywrapper section h2 {
28-
margin-block-start: 0;
29-
padding-block-start: 0.83em;
30-
}
31-
div.citation p {
32-
display: inline;
33-
}
34-
div.flowchart-container {
35-
max-width: 1200px;
36-
}
37-
div.footer {
38-
background-color: var(--bg-dark, #11303D);
39-
}
40-
div.sphinxsidebar {
41-
background-color: var(--bg-light, #F0F0F0);
42-
}
43-
44-
object {
45-
max-width: 100%;
46-
}
47-
48-
.bibtex .brackets::before {
49-
content: "[";
50-
}
51-
.bibtex .brackets::after {
52-
content: "]"
53-
}
54-
55-
.bibtex.label {
56-
display: grid;
57-
}
58-
59-
section[id^="Tutorial:"] p img {
60-
max-width: 80%;
1+
.svg-flowchart > svg {
2+
width: 100%;
3+
height: auto;
614
}

docs/_sources/conf.py

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -430,6 +430,12 @@ def _unireplace(release_note, unireplace):
430430
# so a file named 'default.css' will overwrite the builtin 'default.css'.
431431
html_static_path = ['_static']
432432

433+
# These paths are either relative to html_static_path
434+
# or fully qualified paths (eg. https://...)
435+
html_css_files = [
436+
'custom.css',
437+
]
438+
433439
# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
434440
# using the given strftime format.
435441
# html_last_updated_fmt = '%b %d, %Y'

docs/_sources/developer/continuous_integration.rst

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,9 @@ Continuous Integration
33

44
Our continous integration flow relies on GitHub Actions, GitHub Container Registry, CircleCI and Docker Hub. GitHub Actions builds staging images based on changes to Dockerfiles and pushes those images to GitHub Container Registry. On each push, once staging images are built or determined to be up to date, GitHub Actions installs C-PAC into a development image for each variant (standard, lite, fMRIPrep-LTS, and ABCD-HCP). CircleCI runs tests in both Docker and Singularity for each of these images and generates a coverage report if all tests pass. On release, CircleCI also pushes production images to Docker Hub.
55

6-
.. raw:: html
6+
.. container:: svg-flowchart
77

8-
<a href="../_static/flowcharts/CI-flow.svg"><img src="../_static/flowcharts/CI-flow.svg" /></a>
8+
.. raw:: html
9+
:file: ../_static/flowcharts/CI-flow.svg
10+
11+
`Open image <../_static/flowcharts/CI-flow.svg>`_

docs/_sources/developer/logging.rst

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,12 @@ Logging
33

44
Most C-PAC logging is handled by the built-in Python ``logging`` library. When logging, take care to choose an appropriate ``getLogger`` function or method. While :py:func:`CPAC.utils.monitoring.custom_logging.getLogger` and ``nipype.utils.logger.Logging.getLogger`` each fall back on ``logging.getLogger``,
55

6-
.. raw:: html
6+
.. container:: svg-flowchart
77

8-
<a href="../_static/flowcharts/getLogger.svg"><img src="../_static/flowcharts/getLogger.svg" /></a>
8+
.. raw:: html
9+
:file: ../_static/flowcharts/getLogger.svg
10+
11+
`Open image <../_static/flowcharts/getLogger.svg>`_
912

1013

1114
each have their own intended use cases.

docs/_sources/user/anat.rst

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,12 @@
11
Anatomical Preprocessing
22
------------------------
33

4-
.. raw:: html
4+
.. container:: svg-flowchart
55

6-
<a href="../_static/flowcharts/anatomical.svg"><img src="../_static/flowcharts/anatomical.svg" /></a>
6+
.. raw:: html
7+
:file: ../_static/flowcharts/anatomical.svg
8+
9+
`Open image <../_static/flowcharts/anatomical.svg>`_
710

811
Surface Analysis
912
^^^^^^^^^^^^^^^^
@@ -294,9 +297,12 @@ Configuring CPAC to Run Anatomical Registration
294297
Anatomical Tissue Segmentation
295298
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
296299

297-
.. raw:: html
300+
.. container:: svg-flowchart
301+
302+
.. raw:: html
303+
:file: ../_static/flowcharts/segmentation.svg
298304

299-
<a href="../_static/flowcharts/segmentation.svg"><img src="../_static/flowcharts/segmentation.svg" /></a>
305+
`Open image <../_static/flowcharts/segmentation.svg>`_
300306

301307
C-PAC uses `FSL/FAST <http://fsl.fmrib.ox.ac.uk/fsl/fslwiki/FAST>`_ to automatically segment brain images into white matter, gray matter, and CSF. This is done using probability maps that contain information about the likelihood that a given voxel will be of a particular tissue type. Users specify a probability threshold such that voxels meeting a minimum probability of being a particular tissue will be classified as such. This results in masks containing voxels of only a single tissue type.
302308

docs/_sources/user/func.rst

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,12 @@
11
Functional Preprocessing
22
-------------------------
33

4-
.. raw:: html
4+
.. container:: svg-flowchart
55

6-
<a href="../_static/flowcharts/functional.svg"><img src="../_static/flowcharts/functional.svg" /></a>
6+
.. raw:: html
7+
:file: ../_static/flowcharts/functional.svg
8+
9+
`Open image <../_static/flowcharts/functional.svg>`_
710

811
Initial Preprocessing
912
^^^^^^^^^^^^^^^^^^^^^

docs/_sources/user/longitudinal.rst

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,12 @@
11
Longitudinal Preprocessing
22
--------------------------
33

4-
.. raw:: html
4+
.. container:: svg-flowchart
55

6-
<a href="../_static/flowcharts/longitudinal.svg"><img src="../_static/flowcharts/longitudinal.svg" /></a>
6+
.. raw:: html
7+
:file: ../_static/flowcharts/longitudinal.svg
8+
9+
`Open image <../_static/flowcharts/longitudinal.svg>`_
710

811
Background
912
^^^^^^^^^^

docs/_sources/user/pipelines/configurable-settings.rst

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,12 @@
11
Configurable Settings
22
---------------------
33

4-
.. raw:: html
4+
.. container:: svg-flowchart
55

6-
<a href="../../_static/flowcharts/pipeline-individual.svg"><img src="../../_static/flowcharts/pipeline-individual.svg" /></a>
6+
.. raw:: html
7+
:file: ../../_static/flowcharts/pipeline-individual.svg
8+
9+
`Open image <../../_static/flowcharts/pipeline-individual.svg>`_
710

811
.. toctree::
912
:maxdepth: 1

docs/_sources/user/pipelines/pipeline_config.rst

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -95,9 +95,12 @@ You may notice as you learn about the settings for various outputs that many of
9595
Configurable Settings
9696
------------------------------
9797

98-
.. raw:: html
98+
.. container:: svg-flowchart
9999

100-
<a href="../../_static/flowcharts/pipeline-individual.svg"><img src="../../_static/flowcharts/pipeline-individual.svg" /></a>
100+
.. raw:: html
101+
:file: ../../_static/flowcharts/pipeline-individual.svg
102+
103+
`Open image <../../_static/flowcharts/pipeline-individual.svg>`_
101104

102105
Data Management and Environment Settings
103106
'''''''''''''''''''''''''''''''''''''''''

docs/_sources/user/preprocessing.rst

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,9 +2,12 @@ Pre-Processing Steps
22
====================
33

44

5-
.. raw:: html
5+
.. container:: svg-flowchart
66

7-
<a href="../_static/flowcharts/pipeline-individual.svg"><img src="../_static/flowcharts/pipeline-individual.svg" /></a>
7+
.. raw:: html
8+
:file: ../_static/flowcharts/pipeline-individual.svg
9+
10+
`Open image <../_static/flowcharts/pipeline-individual.svg>`_
811

912
The following index provides links to pages containing overviews and configuration instructions for the various pre-processing steps that C-PAC performs. For more information about how to set up a pipeline configuration, see the :doc:`pipeline configuration page </user/pipelines/pipeline_config>`.
1013

0 commit comments

Comments
 (0)