|
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