Skip to content

Commit

Permalink
Update GitHub Pages
Browse files Browse the repository at this point in the history
  • Loading branch information
zhfeng committed Oct 2, 2024
1 parent 106ff5a commit 7651a44
Show file tree
Hide file tree
Showing 6,575 changed files with 4,699,175 additions and 0 deletions.
The diff you're trying to view is too large. We only load the first 3000 changed files.
11,589 changes: 11,589 additions & 0 deletions docs/1000contributors/index.html

Large diffs are not rendered by default.

376 changes: 376 additions & 0 deletions docs/404.html

Large diffs are not rendered by default.

1 change: 1 addition & 0 deletions docs/CNAME
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
cn.quarkus.io
6 changes: 6 additions & 0 deletions docs/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# 为Quarkus.io网站贡献力量

Contributions are welcome, please submit pull requests for the `main` branch.

**重要:** 指南保存在主Quarkus仓库中,合并请求应该提交在那里:
https://github.com/quarkusio/quarkus/tree/main/docs/src/main/asciidoc.
168 changes: 168 additions & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
# Quarkus.io网站基于Jekyll

## 入门指南

这些指令会给你一份Quarkus.io网站的副本,启动并运行在本地机器上,用于开发和测试。

### 安装

#### Using Docker

1. Install [Docker Desktop](https://docs.docker.com/install/).

2.[项目 repository](https://github.com/quarkusio/quarkusio.github.io)打分支,然后克隆您的 fork.


git clone [email protected]:YOUR_USER_NAME/quarkusio.github.io.git

3. 切换到工程目录:


cd quarkusio.github.io
4. Run Docker Composer

docker compose up

If any error occurs mentioning the name conflict, try

docker compose up --force-recreate

5. 现在用浏览器访问 http://localhost:4000

#### Using a local Ruby environment
[Jekyll 静态站点生成器文档](https://jekyllrb.com/docs/).

1. Install a full [Ruby development environment](https://jekyllrb.com/docs/installation/). If you use `rvm`, run: `rvm use 3.2.3`.

2. 安装 [bundler](https://jekyllrb.com/docs/ruby-101/#bundler) [gems](https://jekyllrb.com/docs/ruby-101/#gems)


gem install bundler

3.[项目 repository](https://github.com/quarkusio/quarkusio.github.io)打分支,然后克隆您的 fork.


git clone [email protected]:YOUR_USER_NAME/quarkusio.github.io.git

4. 切换到工程目录:


cd quarkusio.github.io

5. 使用bundler获取各自版本中所需的所有gems


bundle install

6. 构建站点并使其在本地服务器上可用


./serve.sh

Or if you want it faster and okay to not have guides included use the following:

./serve-noguides.sh


7. 现在用浏览器访问 http://localhost:4000


> 如果您在上述过程中遇到任何意外错误,请参阅 [排错](https://jekyllrb.com/docs/troubleshooting/#configuration-problems) 页面或者 [需求](https://jekyllrb.com/docs/installation/#requirements) 页面,因为您可能会错过开发headers或其他先决条件。
**更多关于使用Jekyll,请参考 [Jekyll循序渐进教程](https://jekyllrb.com/docs/step-by-step/01-setup/).**

### 部署到GitHub页面

The website deployment is automatically performed by GitHub Actions (when commits are pushed to the `main` branch).
If for some reason you need to deploy from your local machine, follow these instructions:

1. 安装 [act](https://github.com/nektos/act#installation) 可执行文件本地运行GitHub Actions

2. 运行 `act -s GITHUB_TOKEN=<GITHUB_TOKEN>`,其中 *<GITHUB_TOKEN>* 需要替换为允许您推送到 https://github.com/quarkusio/quarkusio.github.io repository 的令牌。


## 写博客

> **NOTE:** Using generative AI in *assisting* writing is fine, but please don't use it to write entire posts.
> Used badly, generative AI has a tendency to use complex words and phrasing. This makes
the content hard to read and understand. Always review your blog with a human reader in mind, make sure it's factually correct and especially keep the human touch and opinions in the content.

写博客:

- create an author entry in [_data/authors.yaml](https://github.com/quarkusio/quarkusio.github.io/blob/main/_data/authors.yaml)

- 你可以使用您已经在 [Gravatar service](https://gravatar.com) 注册的电子邮件,在Linux运行 `echo -n [email protected] | md5sum` 或在macOS运行 `echo -n [email protected] | md5` 获得`emailhash`

- create an blog entry under [_posts](https://github.com/quarkusio/quarkusio.github.io/tree/main/_posts)

- the file name is `yyyy-mm-dd-slug.adoc` Set the date to the same value in the asciidoc preamble.

- `tags` 应该谨慎使用,因为存档页面是为它们创建的。以下是一些你可以尝试遵循的基本规则:

- `quarkus-release` 用于Quarkus发布博客

- `announcement` 用于具有一定影响的一般公告。

- `extension` 用于与特定扩展相关的博客。

- `user-story` 用于用户/公司采用Quarkus的故事。

- `development-tips` 用于带有使用Quarkus或Quarkus本身开发提示的博客。

- 如果你的帖子与该技术有显著的相关性,可以添加一个技术细节,比如 `kafka`

- 标记是由空格分隔的列表 `tags:extension grpc`

- 标签必须英文小写

- it's in asciidoc format, there is an example as shown with [2019-06-05-quarkus-and-web-ui-development-mode.adoc](https://github.com/quarkusio/quarkusio.github.io/blob/main/_posts/2019-06-05-quarkus-and-web-ui-development-mode.adoc)

- Be aware that the `date` attribute in the asciidoc preamble defines when the article will be published. Add a `--future` flag when testing locally to ensure the article is included in the generated site.

- send a pull request against the main branch and voilà




## Translations/Localization (l10n)

The primary site (quarkus.io) is written in English.

There are separate repositories for community driven localized versions of quarkus.io:

- [ja.quarkus.io](https://github.com/quarkusio/ja.quarkus.io) for Japanese

- [cn.quarkus.io](https://github.com/quarkusio/cn.quarkus.io) for Chinese (simplified)

- [es.quarkus.io](https://github.com/quarkusio/es.quarkus.io) for Spanish

- [pt.quarkus.io](https://github.com/quarkusio/pt.quarkus.io) for Brazilian Portuguese


If you want to contribute to those efforts read the README in those projects. If you would like to
start another translation, please open an issue in this main repo.

#### Enable DNS for l10n site

Once a localized site has enough of its content translated, DNS needs to be enabled. To do that get one of the Red Hat admins to submit
a ticket to IT asking for XX domain:

```
We need a CNAME record set up for XX.quarkus.io to have it serve out GitHub pages.
The CNAME record for XX.quarkus.io should point to "quarkusio.github.io.".
```

See Step 5 on https://docs.github.com/en/github/working-with-github-pages/managing-a-custom-domain-for-your-github-pages-site for more information.

## 贡献

Please read [CONTRIBUTING.md](https://github.com/quarkusio/quarkusio.github.io/tree/main/CONTRIBUTING.md) for details on our code of conduct, and the process for submitting pull requests to us.

**重要:** 指南保存在主Quarkus仓库中,合并请求应该提交到那里:
https://github.com/quarkusio/quarkus/tree/main/docs/src/main/asciidoc.

## 许可证

本网站是根据 [知识共享署名许可协议 3.0](https://creativecommons.org/licenses/by/3.0/) 维护。
Loading

0 comments on commit 7651a44

Please sign in to comment.