Skip to content

Commit c740245

Browse files
committed
Update GitHub Pages
1 parent cc70ebd commit c740245

File tree

6,575 files changed

+4699578
-0
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

6,575 files changed

+4699578
-0
lines changed

docs/1000contributors/index.html

Lines changed: 11600 additions & 0 deletions
Large diffs are not rendered by default.

docs/404.html

Lines changed: 376 additions & 0 deletions
Large diffs are not rendered by default.

docs/CNAME

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
cn.quarkus.io

docs/CONTRIBUTING.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
# 为Quarkus.io网站贡献力量
2+
3+
Contributions are welcome, please submit pull requests for the `main` branch.
4+
5+
**重要:** 指南保存在主Quarkus仓库中,合并请求应该提交在那里:
6+
https://github.com/quarkusio/quarkus/tree/main/docs/src/main/asciidoc.

docs/README.md

Lines changed: 168 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,168 @@
1+
# Quarkus.io网站基于Jekyll
2+
3+
## 入门指南
4+
5+
这些指令会给你一份Quarkus.io网站的副本,启动并运行在本地机器上,用于开发和测试。
6+
7+
### 安装
8+
9+
#### Using Docker
10+
11+
1. Install [Docker Desktop](https://docs.docker.com/install/).
12+
13+
2.[项目 repository](https://github.com/quarkusio/quarkusio.github.io)打分支,然后克隆您的 fork.
14+
15+
16+
git clone [email protected]:YOUR_USER_NAME/quarkusio.github.io.git
17+
18+
3. 切换到工程目录:
19+
20+
21+
cd quarkusio.github.io
22+
4. Run Docker Composer
23+
24+
docker compose up
25+
26+
If any error occurs mentioning the name conflict, try
27+
28+
docker compose up --force-recreate
29+
30+
5. 现在用浏览器访问 http://localhost:4000
31+
32+
#### Using a local Ruby environment
33+
[Jekyll 静态站点生成器文档](https://jekyllrb.com/docs/).
34+
35+
1. Install a full [Ruby development environment](https://jekyllrb.com/docs/installation/). If you use `rvm`, run: `rvm use 3.2.3`.
36+
37+
2. 安装 [bundler](https://jekyllrb.com/docs/ruby-101/#bundler) [gems](https://jekyllrb.com/docs/ruby-101/#gems)
38+
39+
40+
gem install bundler
41+
42+
3.[项目 repository](https://github.com/quarkusio/quarkusio.github.io)打分支,然后克隆您的 fork.
43+
44+
45+
git clone [email protected]:YOUR_USER_NAME/quarkusio.github.io.git
46+
47+
4. 切换到工程目录:
48+
49+
50+
cd quarkusio.github.io
51+
52+
5. 使用bundler获取各自版本中所需的所有gems
53+
54+
55+
bundle install
56+
57+
6. 构建站点并使其在本地服务器上可用
58+
59+
60+
./serve.sh
61+
62+
Or if you want it faster and okay to not have guides included use the following:
63+
64+
./serve-noguides.sh
65+
66+
67+
7. 现在用浏览器访问 http://localhost:4000
68+
69+
70+
> 如果您在上述过程中遇到任何意外错误,请参阅 [排错](https://jekyllrb.com/docs/troubleshooting/#configuration-problems) 页面或者 [需求](https://jekyllrb.com/docs/installation/#requirements) 页面,因为您可能会错过开发headers或其他先决条件。
71+
72+
**更多关于使用Jekyll,请参考 [Jekyll循序渐进教程](https://jekyllrb.com/docs/step-by-step/01-setup/).**
73+
74+
### 部署到GitHub页面
75+
76+
The website deployment is automatically performed by GitHub Actions (when commits are pushed to the `main` branch).
77+
If for some reason you need to deploy from your local machine, follow these instructions:
78+
79+
1. 安装 [act](https://github.com/nektos/act#installation) 可执行文件本地运行GitHub Actions
80+
81+
2. 运行 `act -s GITHUB_TOKEN=<GITHUB_TOKEN>`,其中 *<GITHUB_TOKEN>* 需要替换为允许您推送到 https://github.com/quarkusio/quarkusio.github.io repository 的令牌。
82+
83+
84+
## 写博客
85+
86+
> **NOTE:** Using generative AI in *assisting* writing is fine, but please don't use it to write entire posts.
87+
> Used badly, generative AI has a tendency to use complex words and phrasing. This makes
88+
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.
89+
90+
写博客:
91+
92+
- create an author entry in [_data/authors.yaml](https://github.com/quarkusio/quarkusio.github.io/blob/main/_data/authors.yaml)
93+
94+
- 你可以使用您已经在 [Gravatar service](https://gravatar.com) 注册的电子邮件,在Linux运行 `echo -n [email protected] | md5sum` 或在macOS运行 `echo -n [email protected] | md5` 获得`emailhash`
95+
96+
97+
- create an blog entry under [_posts](https://github.com/quarkusio/quarkusio.github.io/tree/main/_posts)
98+
99+
- the file name is `yyyy-mm-dd-slug.adoc` Set the date to the same value in the asciidoc preamble.
100+
101+
- `tags` 应该谨慎使用,因为存档页面是为它们创建的。以下是一些你可以尝试遵循的基本规则:
102+
103+
- `quarkus-release` 用于Quarkus发布博客
104+
105+
- `announcement` 用于具有一定影响的一般公告。
106+
107+
- `extension` 用于与特定扩展相关的博客。
108+
109+
- `user-story` 用于用户/公司采用Quarkus的故事。
110+
111+
- `development-tips` 用于带有使用Quarkus或Quarkus本身开发提示的博客。
112+
113+
- 如果你的帖子与该技术有显著的相关性,可以添加一个技术细节,比如 `kafka`
114+
115+
- 标记是由空格分隔的列表 `tags:extension grpc`
116+
117+
- 标签必须英文小写
118+
119+
- 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)
120+
121+
- 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.
122+
123+
- send a pull request against the main branch and voilà
124+
125+
126+
127+
128+
## Translations/Localization (l10n)
129+
130+
The primary site (quarkus.io) is written in English.
131+
132+
There are separate repositories for community driven localized versions of quarkus.io:
133+
134+
- [ja.quarkus.io](https://github.com/quarkusio/ja.quarkus.io) for Japanese
135+
136+
- [cn.quarkus.io](https://github.com/quarkusio/cn.quarkus.io) for Chinese (simplified)
137+
138+
- [es.quarkus.io](https://github.com/quarkusio/es.quarkus.io) for Spanish
139+
140+
- [pt.quarkus.io](https://github.com/quarkusio/pt.quarkus.io) for Brazilian Portuguese
141+
142+
143+
If you want to contribute to those efforts read the README in those projects. If you would like to
144+
start another translation, please open an issue in this main repo.
145+
146+
#### Enable DNS for l10n site
147+
148+
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
149+
a ticket to IT asking for XX domain:
150+
151+
```
152+
We need a CNAME record set up for XX.quarkus.io to have it serve out GitHub pages.
153+
154+
The CNAME record for XX.quarkus.io should point to "quarkusio.github.io.".
155+
```
156+
157+
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.
158+
159+
## 贡献
160+
161+
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.
162+
163+
**重要:** 指南保存在主Quarkus仓库中,合并请求应该提交到那里:
164+
https://github.com/quarkusio/quarkus/tree/main/docs/src/main/asciidoc.
165+
166+
## 许可证
167+
168+
本网站是根据 [知识共享署名许可协议 3.0](https://creativecommons.org/licenses/by/3.0/) 维护。

0 commit comments

Comments
 (0)