README.md · pangang107/vertx-web-site

# Vert.x Website ![Node.js CI](https://github.com/vertx-web-site/vertx-web-site/workflows/Node.js%20CI/badge.svg)

[翻译说明](./README.zh-CN.md)

This repository contains the source of the Vert.x website (https://vertx.io).

## Quickstart

To build the project, before running `npm install`, be sure to have installed `libsass` and `vips`.
On Fedora:

```
sudo dnf install g++ libsass libsass-devel vips-devel
```

Initialize local copy:

npm i

Download, extract and compile AsciiDoc source files of the Vert.x documentation:

npm run update-docs

Start the website in development mode:

npm run dev

Export a static website:

npm run build

The website will be exported the `out` directory.

Test the exported website:

cd out
    npx serve

## Docker

If you don't want to install Node.js, use Docker instead:

```
# Initialize local copy
rm -rf node_modules docs/node_modules
docker run -it -v $(pwd):/vertx node:16-slim sh -c "cd /vertx && npm i"

# Download, extract, and compile docs
docker run -it -v $(pwd):/vertx node:16-slim sh -c "cd /vertx && npm run update-docs"

# Start website in development mode
docker run -it -v $(pwd):/vertx -p 3000:3000 node:16-slim \
  sh -c "cd /vertx && npm run dev"
```

Alternatively, build a Docker image that runs the static website inside NGINX
(no hot reloading!):

docker build -t vertx-web-site .
    docker run -it -p 80:80 vertx-web-site

## Automatic generation of the list of contributors

The community page contains a list of people who have contributed to any of the
Vert.x repositories. Generating this list takes some time and requires you to
authenticate against the GitHub API. Due to this, it is disabled by default.

If you want to generate the list of contributors, first create a
[personal access token](https://github.com/settings/tokens). Then, set the
environment variable `GITHUB_ACCESS_TOKEN` to this token. For example,

GITHUB_ACCESS_TOKEN=abcdefghijklmnopqrs0123456789 npm run build

## Automated deployment

The website is currently automatically deployed to https://vertx-web-site.github.io/.
For this, we set up a separate [GitHub repository](https://github.com/vertx-web-site/vertx-web-site.github.io)
with [GitHub Pages](https://pages.github.com/).

We also created a [GitHub Actions Workflow](https://github.com/vertx-web-site/vertx-web-site/actions).
This workflow runs each time a new commit is pushed. It builds the website and completely
replaces the contents of the GitHub Pages repository, which in turn triggers a new
deployment of the website.

pangang107/vertx-web-site

简介

发行版

贡献者

近期动态

pangang107/vertx-web-site .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

pangang107/vertx-web-site