|
1 | | - |
2 | | - |
3 | | -## Data Carpentry Website |
4 | | - |
5 | | -This is the repository for the Data Carpentry website: <https://datacarpentry.org>. |
6 | | - |
7 | | -The website template and theme is from [»Feeling Responsive«](https://github.com/Phlow/feeling-responsive), a flexible theme for Jekyll built on Foundation framework. |
8 | | -Developed by [Moritz Sauer](https://github.com/Phlow) |
9 | | - |
10 | | -## Setup |
11 | | - |
12 | | -The website uses [Jekyll](http://jekyllrb.com/), a static website generator written in Ruby. |
13 | | -You need to have Version 2.7.1 or higher of Ruby and the package manager Bundler (The package manager is used to make sure you use exactly the same versions of software as GitHub Pages). |
14 | | -Bundler can be installed with `gem install bundler`. |
15 | | -If you are on Linux, you will need to install the Ruby header files (e.g., `sudo apt-get install ruby-dev` on Debian/Ubuntu). |
16 | | -After checking out the repository, please run: |
17 | | - |
18 | | -``` |
19 | | -$ bundle update |
20 | | -``` |
21 | | - |
22 | | -to install Jekyll and the software it depends on. |
23 | | -You may consult [Using Jekyll with Pages](https://help.github.com/articles/using-jekyll-with-pages/) for further instructions. |
24 | | - |
25 | | - |
26 | | -## Previewing |
27 | | - |
28 | | -Please do **not** use `jekyll build` or `jekyll serve` directly to build or view the website. |
29 | | -Instead, you should use the following commands: |
30 | | - |
31 | | -* `make` or `make commands`: list available commands. |
32 | | -* `make serve`: build files locally and run a server at [http://0.0.0.0:4000/](http://0.0.0.0:4000/) for viewing. |
33 | | - This is the best way to preview the site. |
34 | | -* `make site`: build files locally, but do not serve them dynamically. |
35 | | -* `make clean` removes the `_site` directory and any Emacs editor backup files littering the source directories. |
36 | | - |
37 | | - |
38 | | -## Deployment with GitHub Actions |
39 | | - |
40 | | -The default branch for this repository is `main`. All pull requests should be made from there. |
41 | | -Pushing to the `main` branch triggers GitHub Actions. The script: |
42 | | -- checks that the YAML headers in pages and blog posts are valid; |
43 | | -- gets the latest version of the data feeds for the list of past and upcoming workshops; |
44 | | -- builds the website; |
45 | | -- pushes to the `gh-pages` branch. |
46 | | - |
47 | | -GitHub pages takes care of generating the website from the content of the |
48 | | -`gh-pages` branch. Note that because of current limitations with GitHub, we need |
49 | | -to keep the name of the repository `datacarpentry.github.io` to ensure that all |
50 | | -our lessons are available from `https://datacarpentry.org/<name-of-lesson-repository>`. |
| 1 | +This repository has been archived as of 16 November 2024, in favor of the new repository for the [Data Carpentry website](https://github.com/datacarpentry/datacarpentry.org). |
0 commit comments