Use this repo as a template to build your own software website.
-
The template has suggested formatting, links, and content suggestions embedded within .md files.
-
Edit the suggested headings & content to fit your use-case.
-
Comments with instructions start with
[//]:
comments will not appear on the website -
You can hide pages that aren't relevant to your site by adding
nav_exclude: true
to the file header. -
Internal links within the template should continue to work as long as you don't change the file names or page parent (
has_children: true
) children (parent: parent page title
).
1. In your GitHub account, import "labsyspharm/blank-software-website" as a new repo
You can do this two ways - online through github.com or locally using terminal and a text editor.
The jekyll tutorial website includes some Markdown basic syntax to get you started, and we've included some useful basics below.
- Clone the repo
- This will insert blank-software-website files into your current directory
- You can find the https link for your new repo on the green 'code' button on the main repo page
$ git clone <https>
- Navigate into the docs folder
$ cd blank-software-website/docs/
- Generate a local website to preview
$ bundle exec jekyll serve
The site address will be visible in your terminal, probably http://localhost:4000/
- You can now make edits to the website files locally using your favorite text editor.
- To edit an existing page, open the markdown file and start editing it by clicking the pencil icon in the top right tool bar. You can commit these changes directly to your repo.
- If you want to see the changes you've made, you can go ahead and publish the website. Changes will take a few minutes to appear on the website (and require a page refresh).
config.yml contains the overall formatting of the site. See the Jekyyl Tutorial for more information.
- Change the title - this will display as the name of your site
- You must change all instances of 'blank-software-website' to the name of your current repo.
- Ensure that you have made a license file for the software and add in the relevant path to this file.
- Update the path to your banner image and logo
- You may toggle the color theme if desired
- Go the the settings of your repo: https://github.com/.../repo-name/settings/pages
- Click 'pages' on the left hand menu
- Select the branch you want to publish, 'docs' as the source folder, and hit 'save'
- Your website url will display above (username.github.io/repo-name)
See the Just the Docs - LSP page for complete and thorough information about how to edit the template format!
[Display text](URL){:target="_blank"}
[Link button](http://example.com/){: .btn }
[Link button](http://example.com/){: .btn .btn-blue }
[Link button](http://example.com/){: .btn .btn-green }
[Link button](http://example.com/){: .btn .btn-outline }
[Link button](http://example.com/){: .btn .btn-outline .btn-arrow }
*Back to top buttons are very useful for long pages!
Bulleted list
<details open markdown="block">
<summary>
Table of contents
</summary>
{: .text-delta }
- TOC
{:toc}
</details>
Numbered list
<details open markdown="block">
<summary>
Table of contents
</summary>
{: .text-delta }
1. TOC
{:toc}
</details>
You'll find 4 examples of how to define images in the example data set page
Use <br>
to add extra spacing
| | | |
|---|---|---|
| | | |
| | | |
For more tips to get started, visit the Jekyll tutorial FAQ. Thorough documentation for editing the website theme can be accessed at Just the Docs - LSP.