init

Author: hhstore

docs/ecosystem/00-index.md

@@ -0,0 +1,54 @@
+---
+sidebar_position: 0
+---
+
+# Zig 生态
+
+## Awesome:
+
+- https://github.com/hhstore/blog/issues/374
+
+> search:
+
+- https://github.com/topics/ziglang
+- https://github.com/topics/zig
+
+> awesome:
+
+- https://github.com/nrdmn/awesome-zig
+- https://github.com/catdevnull/awesome-zig
+- https://github.com/C-BJ/awesome-zig
+
+> 学习教程:
+
+- https://github.com/Sobeston/ziglearn
+- https://ziglearn.org/
+- https://github.com/ratfactor/ziglings
+
+## Zig 工具链:
+
+> zig 编辑器 theme 主体配色:
+
+- https://github.com/benbusby/colorstorm
+
+> zig 版本管理工具:
+
+- https://github.com/marler8997/zigup
+
+> zig 包管理工具:
+
+- https://github.com/catdevnull/awesome-zig#package-managers
+- https://github.com/zigtools/zpm
+- https://github.com/mattnite/gyro
+- https://github.com/nektro/zigmod
+- https://aquila.red/
+- https://zig.pm/
+- https://astrolabe.pm/
+
+> zig 代码分享:
+
+- https://zigbin.io/
+
+> lint:
+
+- https://github.com/nektro/ziglint

docs/ecosystem/01-core-libs/01-client.md

@@ -0,0 +1,2 @@
+# zig web 客户端:
+

docs/ecosystem/01-core-libs/02-server.md

@@ -0,0 +1,5 @@
+# zig web 服务端:
+
+## web 框架:
+
+## web 中间件:

docs/ecosystem/02-web/01-client.md

@@ -0,0 +1,2 @@
+# zig web 客户端:
+

docs/ecosystem/02-web/02-server.md

@@ -0,0 +1,5 @@
+# zig web 服务端:
+
+## web 框架:
+
+## web 中间件:

docs/guide/01-intro.md

@@ -0,0 +1,15 @@
+---
+sidebar_position: 1
+---
+
+# Zig 教程
+
+## 快速开始:
+
+- https://github.com/hhstore/blog/issues/363
+
+## 官网:
+
+- https://ziglang.org/zh/learn/samples
+
+## 搭建开发环境:

docs/tutorial-basics/_category_.json renamed to docs/guide/02-tutorial-basics/_category_.json

@@ -1,5 +1,5 @@
 {
-  "label": "Tutorial - Basics",
+  "label": "基本语法",
   "position": 2,
   "link": {
     "type": "generated-index",

docs/tutorial-basics/congratulations.md renamed to docs/guide/02-tutorial-basics/congratulations.md

@@ -0,0 +1,8 @@
+{
+  "label": "参考资料",
+  "position": 4,
+  "link": {
+    "type": "generated-index",
+    "description": "参考资料/文献."
+  }
+}

docs/tutorial-basics/create-a-blog-post.md renamed to docs/guide/02-tutorial-basics/create-a-blog-post.md

@@ -0,0 +1,21 @@
+---
+sidebar_position: 6
+---
+
+# Congratulations!
+
+You have just learned the **basics of Docusaurus** and made some changes to the **initial template**.
+
+Docusaurus has **much more to offer**!
+
+Have **5 more minutes**? Take a look at **[versioning](../tutorial-extras/manage-docs-versions.md)** and **[i18n](../tutorial-extras/translate-your-site.md)**.
+
+Anything **unclear** or **buggy** in this tutorial? [Please report it!](https://github.com/facebook/docusaurus/discussions/4610)
+
+## What's next?
+
+- Read the [official documentation](https://docusaurus.io/).
+- Add a custom [Design and Layout](https://docusaurus.io/docs/styling-layout)
+- Add a [search bar](https://docusaurus.io/docs/search)
+- Find inspirations in the [Docusaurus showcase](https://docusaurus.io/showcase)
+- Get involved in the [Docusaurus Community](https://docusaurus.io/community/support)

docs/tutorial-basics/create-a-document.md renamed to docs/guide/02-tutorial-basics/create-a-document.md

@@ -0,0 +1,34 @@
+---
+sidebar_position: 3
+---
+
+# Create a Blog Post
+
+Docusaurus creates a **page for each blog post**, but also a **blog index page**, a **tag system**, an **RSS** feed...
+
+## Create your first Post
+
+Create a file at `blog/2021-02-28-greetings.md`:
+
+```md title="blog/2021-02-28-greetings.md"
+---
+slug: greetings
+title: Greetings!
+authors:
+  - name: Joel Marcey
+    title: Co-creator of Docusaurus 1
+    url: https://github.com/JoelMarcey
+    image_url: https://github.com/JoelMarcey.png
+  - name: Sébastien Lorber
+    title: Docusaurus maintainer
+    url: https://sebastienlorber.com
+    image_url: https://github.com/slorber.png
+tags: [greetings]
+---
+
+Congratulations, you have made your first post!
+
+Feel free to play around and edit this post as much you like.
+```
+
+A new blog post is now available at [http://localhost:3000/blog/greetings](http://localhost:3000/blog/greetings).

docs/tutorial-basics/create-a-page.md renamed to docs/guide/02-tutorial-basics/create-a-page.md

@@ -0,0 +1,55 @@
+---
+sidebar_position: 2
+---
+
+# Create a Document
+
+Documents are **groups of pages** connected through:
+
+- a **sidebar**
+- **previous/next navigation**
+- **versioning**
+
+## Create your first Doc
+
+Create a Markdown file at `docs/hello.md`:
+
+```md title="docs/hello.md"
+# Hello
+
+This is my **first Docusaurus document**!
+```
+
+A new document is now available at [http://localhost:3000/docs/hello](http://localhost:3000/docs/hello).
+
+## Configure the Sidebar
+
+Docusaurus automatically **creates a sidebar** from the `docs` folder.
+
+Add metadata to customize the sidebar label and position:
+
+```md title="docs/hello.md" {1-4}
+---
+sidebar_label: 'Hi!'
+sidebar_position: 3
+---
+
+# Hello
+
+This is my **first Docusaurus document**!
+```
+
+It is also possible to create your sidebar explicitly in `sidebars.js`:
+
+```js title="sidebars.js"
+module.exports = {
+  tutorialSidebar: [
+    {
+      type: 'category',
+      label: 'Tutorial',
+      // highlight-next-line
+      items: ['hello'],
+    },
+  ],
+};
+```

docs/tutorial-basics/deploy-your-site.md renamed to docs/guide/02-tutorial-basics/deploy-your-site.md

@@ -0,0 +1,43 @@
+---
+sidebar_position: 1
+---
+
+# Create a Page
+
+Add **Markdown or React** files to `src/pages` to create a **standalone page**:
+
+- `src/pages/index.js` → `localhost:3000/`
+- `src/pages/foo.md` → `localhost:3000/foo`
+- `src/pages/foo/bar.js` → `localhost:3000/foo/bar`
+
+## Create your first React Page
+
+Create a file at `src/pages/my-react-page.js`:
+
+```jsx title="src/pages/my-react-page.js"
+import React from 'react';
+import Layout from '@theme/Layout';
+
+export default function MyReactPage() {
+  return (
+    <Layout>
+      <h1>My React page</h1>
+      <p>This is a React page</p>
+    </Layout>
+  );
+}
+```
+
+A new page is now available at [http://localhost:3000/my-react-page](http://localhost:3000/my-react-page).
+
+## Create your first Markdown Page
+
+Create a file at `src/pages/my-markdown-page.md`:
+
+```mdx title="src/pages/my-markdown-page.md"
+# My Markdown page
+
+This is a Markdown page
+```
+
+A new page is now available at [http://localhost:3000/my-markdown-page](http://localhost:3000/my-markdown-page).

docs/tutorial-basics/markdown-features.mdx renamed to docs/guide/02-tutorial-basics/markdown-features.mdx

@@ -0,0 +1,31 @@
+---
+sidebar_position: 5
+---
+
+# Deploy your site
+
+Docusaurus is a **static-site-generator** (also called **[Jamstack](https://jamstack.org/)**).
+
+It builds your site as simple **static HTML, JavaScript and CSS files**.
+
+## Build your site
+
+Build your site **for production**:
+
+```bash
+npm run build
+```
+
+The static files are generated in the `build` folder.
+
+## Deploy your site
+
+Test your production build locally:
+
+```bash
+npm run serve
+```
+
+The `build` folder is now served at [http://localhost:3000/](http://localhost:3000/).
+
+You can now deploy the `build` folder **almost anywhere** easily, **for free** or very small cost (read the **[Deployment Guide](https://docusaurus.io/docs/deployment)**).