1479ac58db
* Update github-pages requirement from ~> 231 to ~> 232 Updates the requirements on [github-pages](https://github.com/github/pages-gem) to permit the latest version. - [Release notes](https://github.com/github/pages-gem/releases) - [Commits](https://github.com/github/pages-gem/compare/v231...v232) --- updated-dependencies: - dependency-name: github-pages dependency-type: direct:production ... Signed-off-by: dependabot[bot] <support@github.com> * Update Gemfile * Create .ruby-version --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Sean Killeen <SeanKilleen@gmail.com> |
||
---|---|---|
.devcontainer | ||
.github | ||
.vscode | ||
_includes | ||
_layouts | ||
_posts | ||
_sass | ||
css | ||
favicons | ||
files | ||
fonts/bootstrap | ||
img | ||
index.php | ||
js | ||
nuget | ||
.editorconfig | ||
.gitattributes | ||
.gitignore | ||
.ruby-version | ||
404.html | ||
CNAME | ||
CODE_OF_CONDUCT.md | ||
Gemfile | ||
LICENSE | ||
README.md | ||
_config.yml | ||
atom.xml | ||
contact.md | ||
donations.md | ||
download.html | ||
feed.xml | ||
index.html | ||
news.html | ||
rss.xml | ||
sitemap.txt |
README.md
NUnit.org website
To get started developing the website, you have two options. You can develop in a Docker Container using VS Code, or you can install Ruby locally and develop locally.
Installing Docker and VS Code
Do this if you want to develop in a Docker container using VS Code.
-
Install and configure Docker for your operating system.
Windows / macOS:
- Install Docker Desktop for Windows/Mac.
- Right-click on the Docker taskbar item and update Settings / Preferences > Shared Drives / File Sharing with the drive the web app source code is located in. If you run into trouble, see Docker Desktop for Windows tips on avoiding common problems with sharing.
Linux:
- Follow the official install instructions for Docker CE/EE for your distribution.
- Add your user to the
docker
group by using a terminal to run:sudo usermod -aG docker $USER
- Sign out and back in again so your changes take effect.
-
Install Visual Studio Code.
-
Install the Remote Development extension pack.
Quick Start for Docker with VSCode
-
Start VS Code and click on the quick actions Status Bar item in the lower left corner of the window.
-
Select Remote-Containers: Open Folder in Container... from the command list that appears, and open the root folder of the project you just cloned.
-
The window will then reload, but since the container does not exist yet, VS Code will create one. This may take some time, and a progress notification will provide status updates. Fortunately, this step isn't necessary the next time you open the folder since the container will already exist.
-
After the container is built, VS Code automatically connects to it and maps the project folder from your local file system into the container.
-
Open the terminal in VS Code to a bash prompt within the container by clicking on Terminal > New Terminal
-
In the terminal, type
bundle exec jekyll serve
to build and run the web site. (See below) -
Open the web site at http://localhost:4000.
-
Begin developing in Visual Studio Code.
Installing Ruby and Jekyll locally
- Install Ruby 2.2 (Linux, Mac, Windows)
- If you are on Windows, install DevKit
gem install bundler
bundle install
Building the project
GitHub will do this automatically when you push, but this allows you to view the site locally before you commit.
jekyll serve