Skip to content
This repository was archived by the owner on Feb 26, 2024. It is now read-only.

Commit f4ab557

Browse files
Update README.md
1 parent 2fc8900 commit f4ab557

File tree

1 file changed

+30
-103
lines changed

1 file changed

+30
-103
lines changed

README.md

Lines changed: 30 additions & 103 deletions
Original file line numberDiff line numberDiff line change
@@ -1,103 +1,30 @@
1-
# just-the-docs-template
2-
3-
This is a *bare-minimum* template to create a [Jekyll] site that:
4-
5-
- uses the [Just the Docs] theme;
6-
- can be built and published on [GitHub Pages];
7-
- can be built and previewed locally, and published on other platforms.
8-
9-
More specifically, the created site:
10-
11-
- uses a gem-based approach, i.e. uses a `Gemfile` and loads the `just-the-docs` gem;
12-
- uses the [GitHub Pages / Actions workflow] to build and publish the site on GitHub Pages.
13-
14-
To get started with creating a site, just click "[use this template]"!
15-
16-
After completing the creation of your new site on GitHub, update it as needed:
17-
18-
## Replace the content of the template pages
19-
20-
Update the following files to your own content:
21-
22-
- `index.md` (your new home page)
23-
- `README.md` (information for those who access your site repo on GitHub)
24-
25-
## Changing the version of the theme and/or Jekyll
26-
27-
Simply edit the relevant line(s) in the `Gemfile`.
28-
29-
## Adding a plugin
30-
31-
The Just the Docs theme automatically includes the [`jekyll-seo-tag`] plugin.
32-
33-
To add an extra plugin, you need to add it in the `Gemfile` *and* in `_config.yml`. For example, to add [`jekyll-default-layout`]:
34-
35-
- Add the following to your site's `Gemfile`:
36-
37-
```ruby
38-
gem "jekyll-default-layout"
39-
```
40-
41-
- And add the following to your site's `_config.yml`:
42-
43-
```yaml
44-
plugins:
45-
- jekyll-default-layout
46-
```
47-
48-
Note: If you are using a Jekyll version less than 3.5.0, use the `gems` key instead of `plugins`.
49-
50-
## Publishing your site on GitHub Pages
51-
52-
1. If your created site is `YOUR-USERNAME/YOUR-SITE-NAME`, update `_config.yml` to:
53-
54-
```yaml
55-
title: YOUR TITLE
56-
description: YOUR DESCRIPTION
57-
theme: just-the-docs
58-
59-
url: https://YOUR-USERNAME.github.io/YOUR-SITE-NAME
60-
61-
aux_links: # remove if you don't want this link to appear on your pages
62-
Template Repository: https://github.com/YOUR-USERNAME/YOUR-SITE-NAME
63-
```
64-
65-
2. Push your updated `_config.yml` to your site on GitHub.
66-
67-
3. In your newly created repo on GitHub:
68-
- go to the `Settings` tab -> `Pages` -> `Build and deployment`, then select `Source`: `GitHub Actions`.
69-
- if there were any failed Actions, go to the `Actions` tab and click on `Re-run jobs`.
70-
71-
## Building and previewing your site locally
72-
73-
Assuming [Jekyll] and [Bundler] are installed on your computer:
74-
75-
1. Change your working directory to the root directory of your site.
76-
77-
2. Run `bundle install`.
78-
79-
3. Run `bundle exec jekyll serve` to build your site and preview it at `localhost:4000`.
80-
81-
The built site is stored in the directory `_site`.
82-
83-
## Publishing your built site on a different platform
84-
85-
Just upload all the files in the directory `_site`.
86-
87-
## Customization
88-
89-
You're free to customize sites that you create with this template, however you like!
90-
91-
[Browse our documentation][Just the Docs] to learn more about how to use this theme.
92-
93-
----
94-
95-
[^1]: [It can take up to 10 minutes for changes to your site to publish after you push the changes to GitHub](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll#creating-your-site).
96-
97-
[Jekyll]: https://jekyllrb.com
98-
[Just the Docs]: https://just-the-docs.github.io/just-the-docs/
99-
[GitHub Pages]: https://docs.github.com/en/pages
100-
[Bundler]: https://bundler.io
101-
[use this template]: https://github.com/just-the-docs/just-the-docs-template/generate
102-
[`jekyll-default-layout`]: https://github.com/benbalter/jekyll-default-layout
103-
[`jekyll-seo-tag`]: https://jekyll.github.io/jekyll-seo-tag
1+
# SeptiSearchTutorial
2+
3+
Welcome to SeptiSearchTutorial, the GitHub repository holding the documentation
4+
for SeptiSearch, an interactive Shiny app providing access to manually-curated
5+
molecular sepsis data from current publications. Visit the main site at
6+
[septisearch.ca](https://septisearch.ca).
7+
8+
The SeptiSearch tutorial docs were created using JustTheDocs; more information
9+
is available [here](https://just-the-docs.github.io/just-the-docs/).
10+
11+
## SeptiSearch overview
12+
The SeptiSearch app is designed to allow easy access to curated sepsis gene
13+
sets. Multiple tabs allow the exploration and use of the data in a number of
14+
ways:
15+
16+
- **Explore the Database** makes it easy to search all curated gene sets by
17+
keyword or molecule, filter with select criteria, and view all the molecules in
18+
a gene set
19+
- **Visualize the Database** plots the most common molecules, and provides
20+
filters to see which occur most frequently based on a number of attributes
21+
- **Perform Pathway Enrichment** allows users to upload their own list of genes,
22+
or use one of the curated sepsis gene sets, to test for enriched pathways/terms
23+
using ReactomePA and EnirchR
24+
- **Test for Enriched Sepsis Gene Sets** can be used to test your own expression
25+
data (e.g. counts from RNA-Seq) for dysregulation of the curated sepsis gene
26+
sets
27+
28+
## License
29+
This project uses the MIT license, available
30+
[here](https://github.com/hancockinformatics/SeptiSearchTutorial/blob/main/LICENSE).

0 commit comments

Comments
 (0)