This is the source code for the SciLifeLab Data Platform website: https://data.scilifelab.se/.
This website is maintained by the SciLifeLab Data Centre (GitHub organisation).
The site is built using the Hugo static web site generator, Bootstrap 5 for styling and Bootstrap icons.
Click on 'Cite this repository' near the top right of this repository to see how to formally cite this repository.
All website content is written in Markdown, YAML, or JSON which are all beginner-friendly formats so it should be relatively easy to contribute. Please visit the CONTRIBUTING page for general guidelines and specific instructions on how to contribute to different sections of the Platform.
The code is hosted on GitHub, so you'll need an account.
Next, visit the code repository: https://github.com/ScilifelabDataCentre/data.scilifelab.se
In the top right, you'll see a button that says "Fork". Click this, then select your username. This makes a copy of the repository under your personal account that you can edit.
This is best if you only want to make one or two minor tweaks. If you want to make more substantial edits over a longer time frame, we recommend editing locally (Step 2b).
The easiest way to edit the website files is on the GitHub website.
On the web page of your forked copy of the repository, look in the content/ directory or the data/ directory depending on which section you would like to contribute to (see CONTRIBUTING page for specific instructions).
Go to the markdown file or JSON file that you want to edit, then click the Pencil icon ✏️ in the top right. This opens a web-based editor where you can add and edit content.
When you're finished, scroll to the bottom and fill in / submit the "Commit changes" form.
You're nearly done - you can now skip to Step 3.
If you prefer, you can edit the website files on your computer in your favourite text editor. Just fork the repository to your machine:
git clone [email protected]:[YOUR-USERNAME]/data.scilifelab.se.git
cd data.scilifelab.seTo make it easier to pull in changes made by others, you can add the main repository as a remote:
git remote add upstream https://github.com/ScilifelabDataCentre/data.scilifelab.se.gitThen you can fetch changes at any time from this remote:
git pull upstream developTo keep commit messages consistent, contributors are advised to configure git with the commit message template provided.
This can be achieved by running the following command once in the repository's directory:
git config --local commit.template .github/.gitmessage.txtWhen you have finished editing, commit your changes:
git add .
git commit # This will open your editor with the templateThe commit message will now be pre-filled with the following template:
<type>(scope): <short description>
Replace the <type> and (scope) placeholders with the best matching entry in the following table:
| Type | Description |
|---|---|
| feat | A new feature |
| fix | A bug fix or improvement of existing feature |
| content | New content such as markdown pages |
| docs | Documentation-only changes |
| test | Adding or modifying tests |
| chore | Maintenance, tooling, dependencies update |
Scope is optional but nice to have if deemed relevant.
Examples:
fix(visualization): correct/add genome visualization
feat(dashboard): add SARS-Cov2 dashboard
style(css): reformat layout classes
For the short description, write as if completing "If accepted, my changes are going to...".
And finally push to your fork:
git pushTo view your changes as they will appear in the final website, you need to install Hugo. You can find instructions on the Hugo website: https://gohugo.io/
If you're using Mac OSX, it's recommended to use Homebrew - if homebrew is already set up, installing Hugo is just a case of:
brew install hugoOnce Hugo is installed, simply run the following command in the repository root directory:
$ hugo serve
Start building sites …
hugo v0.92.0+extended darwin/amd64 BuildDate=unknown
| EN
-------------------+-----
Pages | 77
Paginator pages | 0
Non-page files | 0
Static files | 54
Processed images | 0
Aliases | 0
Sitemaps | 1
Cleaned | 0
Built in 83 ms
Watching for changes in /Users/arnold/Documents/data.scilifelab.se/{archetypes,content,data,layouts,static}
Watching for config changes in /Users/arnold/Documents/data.scilifelab.se/config.yaml
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stopUse the URL printed at the bottom of this message (here, it's http://localhost:1313/) to view the site.
Every time you save a file, the page will automatically refresh in the browser.
Configure Markdown Linting Locally (Open Science Content content/open_science/)
To ensure consistent markdown formatting across the website, especially for Open Science content (content/open_science/), we use markdownlint-cli2. The linter uses our custom configuration file (.github/.markdownlint-cli2.yaml) which sets specific rules for our markdown files. Follow these steps to run the linter locally before pushing your changes:
Important: To maintain consistency with our GitHub Actions workflow, please ensure you install the same Node.js version as specified in our markdownlint workflow. This ensures your local environment matches our CI/CD environment.
-
Install Node.js and npm: Following installations instructions are for Node.js version 20 (you should refer to markdownlint workflow for current nodejs version)
For macOS (using Homebrew)
# Install Homebrew if you don't have it /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # Install Node.js (this will include npm) # refer .github/workflows/markdownlint.yaml for exact node version brew install node@20 # Add Node.js to your PATH (if not already done) echo 'export PATH="/usr/local/opt/node@20/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
For Windows
- Download Nodejs LTS (refer markdownlint workflow for exact nodejs version) installer from Nodejs official website
- Run the installer and follow the installation wizard
- Restart your terminal after installation
For Linux (Ubuntu/Debian)
# Using NodeSource repository # refer .github/workflows/markdownlint.yaml for exact nodejs version curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt-get install -y nodejs
-
Verify Installation:
node --version # Should show v20.x.x npm --version # Should show the npm version
-
Install markdownlint-cli2:
npm install -g markdownlint-cli2
-
Run the linter:
markdownlint-cli2 "content/open_science/**/*.md" --config .github/.markdownlint-cli2.yaml
Before committing your changes, run the linter locally to catch and fix any formatting issues. This helps maintain consistent markdown style across the project and prevents CI failures. The same checks will be run automatically in our GitHub Actions workflow when you create a pull request. For detailed information about the linting rules, refer to the markdownlint documentation.
If you would prefer not to use Hugo, you can use the provided Dockerfile to build and run a container.
Once you're finished with your edits and they are committed and pushed to your forked repository, it's time to open a pull request.
You can find full documentation on the GitHub help website, however in short:
- Visit the main repository: https://github.com/ScilifelabDataCentre/data.scilifelab.se
- Click the button that reads "New Pull Request"
- Click the text link near the top that says "compare across forks"
- In the right-hand "head repository" drop down, select your username / fork.
- If you're happy with the list of commits shown, and the diff in the "Files Changed" tab, fill in a title and description and click "Create pull request"
Once created, a member of the website team will review your changes. Once approved, they will be merged and deployed.
For videos which are used for visual interest (e.g. as banners), compress the images as much as possible using a tool such as VEED. Try quality as "medium" and the resolution as "2918 x 720" as a default starting point but always visually inspect the compressed video.
To keep the overall repository small, avoid committing videos over 5MB and store the video elsewhere. Likewise, if the number of MP4s in the repository grows, we likely will move all videos out of the repository.
If in doubt, you can ask for help by emailing [email protected].
The website was built by SciLifeLab Data Centre with the help of some additional SciLifeLab volunteers.