https://github.com/bjohansebas/ruby-githubactions
https://github.com/bjohansebas/ruby-githubactions
Last synced: 5 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/bjohansebas/ruby-githubactions
- Owner: bjohansebas
- License: other
- Created: 2025-02-05T15:06:30.000Z (over 1 year ago)
- Default Branch: gh-pages
- Last Pushed: 2025-02-05T15:43:38.000Z (over 1 year ago)
- Last Synced: 2025-04-09T00:04:02.585Z (about 1 year ago)
- Language: HTML
- Size: 62.9 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# expressjs.com
This is the repository of the website [expressjs.com](https://expressjs.com). It is hosted directly from the repository as a [GitHub Pages](https://pages.github.com/) website.
## Local Setup
To preview the website locally:
1. Install [Ruby and Bundler](https://help.github.com/articles/setting-up-your-pages-site-locally-with-jekyll/) if you don't have them already.
1. Install the [jekyll-redirect-from](https://github.com/jekyll/jekyll-redirect-from) gem:
```sh
$ gem install jekyll-redirect-from
```
1. Clone this repository by running the following command:
```sh
$ git clone https://github.com/expressjs/expressjs.com.git
```
1. Navigate to the cloned repository directory and run the following command:
```sh
$ bundle install
```
Bundler will look in the Gemfile for which gems to install. The `github-pages` gem includes the same version of Jekyll and other dependencies as used by GitHub Pages, so that your local setup mirrors GitHub Pages as closely as possible.
1. Run Jekyll using the following command:
```sh
$ bundle exec jekyll serve
```
Then, load in your browser.
## Local Setup using Docker
>[!TIP]
> You can run `make help` to obtain detailed information on how to use our make commands.
0. Ensure that you have Docker and Make installed.
1. Run `make build` to build the project.
2. Run `make serve` to serve the project, this include live reloading so any change will be reflected (it can take a while, check the logs).
3. Run `make clean` to remove the docker images and resources generated.
## Formatting
Jekyll uses a variant of Markdown known as [Kramdown](https://kramdown.gettalong.org/quickref.html).
Jekyll uses the [Liquid template engine](http://liquidmarkup.org/) for templating.
You can use [GFM](https://kramdown.gettalong.org/parser/gfm.html) fenced code blocks for JavaScript; for example:
```js
var express = require('express')
var app = express()
app.listen(3000)
```
The result looks like this:
```js
const express = require('express')
const app = express()
app.listen(3000)
```
The default GitHub Pages syntax highlighting has been disabled in `_config.yml` to allow highlighting with [prism.js](https://prismjs.com/).
## Contributing
Please see the [Contributors' Guide](CONTRIBUTING.md) for more information on contributing to the Express JS documentation, including information on contributing translations.
## Why use Jekyll instead of an Express-based solution?
Jekyll comes built-in with GitHub Pages. Since we are already using GitHub Pages to host the website, it makes sense to leverage the capabilities it provides. It's all about using the right tool, for the right job, under the right circumstances.