Skip to content

Commit 2733806

Browse files
committed
moving things on the overview page
1 parent 487785b commit 2733806

File tree

1 file changed

+31
-32
lines changed

1 file changed

+31
-32
lines changed

_uw-research-computing/software-overview-htc.md

Lines changed: 31 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ This guide introduces how to build software in a container (our recommended stra
1717
{% capture content %}
1818

1919
- [Start here](#start-here)
20-
- [What approach should I use?](#what-approach-should-i-use)
2120
- [Quickstart by software type](#quickstart-by-software-type)
21+
- [What approach should I use?](#what-approach-should-i-use)
2222
- [Container Overview](#container-overview)
2323
- [Related pages](#related-pages)
2424

@@ -41,11 +41,37 @@ containers.
4141
</div>
4242
</div>
4343

44+
* For more specific guidance about *your* software, see: [Quickstart by software type](#quickstart-by-software-type)
4445
* For more guidance in whether jumping right into Apptainer is best for you:
4546
[What approach should I use?](#what-approach-should-i-use)
46-
* For more specific guidance about *your* software, see: [Quickstart by software type](#quickstart-by-software-type)
4747
* To learn more about containers in general see: [Containers](#container-overview)
4848

49+
## Quickstart by software type
50+
51+
Click the link in the table below to jump to the instructions for the language/program/software that you want to use, and then click on "More Information."
52+
53+
<div class="shadow p-3 border rounded">
54+
<div class="row gx-1">
55+
{% assign pages = site.uw-research-computing | where_exp: "x", "x.software_icon.size > 0" %}
56+
{% for page in pages %}
57+
<div class="col col-6 col-md-2">
58+
<button class="btn btn-guide mb-lg-0 d-flex flex-column {% if forloop.first %}btn-guide-highlighted{% endif %}" href="#quickstart" onclick="showExcerpt('{{ page.title | slugify }}', 'side-divider')">
59+
<img class="img-btn-guide mx-auto" src="{{ page.software_icon }}" alt="{{ page.title }}">
60+
<span class="mx-auto">{{ page.software }}</span>
61+
</button>
62+
</div>
63+
{% endfor %}
64+
</div>
65+
<div class="card-body side-divider" style="display: block;">
66+
{% for page in pages %}
67+
<div class="excerpt" id="{{ page.title | slugify }}" style="display: {% if forloop.first %}block{% else %}none{% endif %};">
68+
{{ page.excerpt | markdownify }}
69+
<a href="{{ page.url }}" style="font-weight: bold; text-decoration: underline;">More Information</a>
70+
</div>
71+
{% endfor %}
72+
</div>
73+
</div>
74+
4975
## What approach should I use?
5076

5177
We recommend using containers for jobs in CHTC for a number of reasons, detailed
@@ -78,40 +104,13 @@ In certain cases, it is reasonable to use a non-container option for software in
78104

79105
If you are not sure what to choose, talk to the facilitation team! That's why we're here.
80106

81-
## Quickstart by software type
82-
83-
Containers are not the only options for software installation on CHTC.
84-
85-
Click the link in the table below to jump to the instructions for the language/program/software that you want to use.
86-
87-
<div class="shadow p-3 border rounded">
88-
<div class="row gx-1">
89-
{% assign pages = site.uw-research-computing | where_exp: "x", "x.software_icon.size > 0" %}
90-
{% for page in pages %}
91-
<div class="col col-6 col-md-2">
92-
<button class="btn btn-guide mb-lg-0 d-flex flex-column {% if forloop.first %}btn-guide-highlighted{% endif %}" href="#quickstart" onclick="showExcerpt('{{ page.title | slugify }}', 'side-divider')">
93-
<img class="img-btn-guide mx-auto" src="{{ page.software_icon }}" alt="{{ page.title }}">
94-
<span class="mx-auto">{{ page.software }}</span>
95-
</button>
96-
</div>
97-
{% endfor %}
98-
</div>
99-
<div class="card-body side-divider" style="display: block;">
100-
{% for page in pages %}
101-
<div class="excerpt" id="{{ page.title | slugify }}" style="display: {% if forloop.first %}block{% else %}none{% endif %};">
102-
{{ page.excerpt | markdownify }}
103-
<a href="{{ page.url }}" style="font-weight: bold; text-decoration: underline;">More Information</a>
104-
</div>
105-
{% endfor %}
106-
</div>
107-
</div>
108107

109108
## Container overview
110109

111110
In this section, we provide a brief introduction into what containers are,
112111
why we recommend them, and a big picture view of how to use them on our High Throughput system.
113112

114-
### What is a Container?
113+
### What is a container?
115114

116115
*"A container is a standard unit of software that packages up code and all its dependencies so the application runs quickly and reliably from one computing environment to another."*
117116
-- [Docker](https://www.docker.com/resources/what-container/)
@@ -181,15 +180,15 @@ These guides talk about how to do the above steps for either Apptainer or Docker
181180
> The software installation process only occurs when the container is actually being built.
182181
> Once the container has been built, no changes can be made to the container when being used (on CHTC systems).
183182
184-
### Recipes
183+
### Container build recipes
185184

186185
If you need to create your own build file, CHTC provides many specific examples
187186
in our "Recipes" repository on Github:
188187
[https://github.com/CHTC/recipes](https://github.com/CHTC/recipes).
189188

190189
Links to specific recipes are used in the [Software](#software) section for certain softwares and coding languages.
191190

192-
### Container Technologies
191+
### Container technologies
193192

194193
There are two container technologies supported by CHTC: [Docker](https://www.docker.com/) and [Apptainer](https://apptainer.org/).
195194
Here we briefly discuss the advantages of each.

0 commit comments

Comments
 (0)