You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@opendal.apache.org by xu...@apache.org on 2024/03/07 03:40:29 UTC
(opendal) branch main updated: docs: publish docs for object-store-opendal (#4328)
This is an automated email from the ASF dual-hosted git repository.
xuanwo pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/opendal.git
The following commit(s) were added to refs/heads/main by this push:
new a2e7749a46 docs: publish docs for object-store-opendal (#4328)
a2e7749a46 is described below
commit a2e7749a465af85b65ff912abf56adee7158cea5
Author: zjregee <89...@users.noreply.github.com>
AuthorDate: Thu Mar 7 11:40:23 2024 +0800
docs: publish docs for object-store-opendal (#4328)
* publish docs for object-store-opendal
* add ci jobs to publish object-store-opendal docs
---
.github/workflows/docs.yml | 35 ++++++++++++++++++++++
README.md | 2 +-
website/docs/integrations/_category_.yml | 24 +++++++++++++++
website/docs/integrations/object_store_opendal.mdx | 9 ++++++
website/docusaurus.config.js | 4 +++
5 files changed, 73 insertions(+), 1 deletion(-)
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 9c50c0878c..0866ff11ae 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -27,6 +27,7 @@ on:
paths:
- "core/**"
- "bindings/**"
+ - "integrations/**"
- ".github/workflows/docs.yml"
concurrency:
@@ -292,6 +293,33 @@ jobs:
name: ocaml-docs
path: ./bindings/ocaml/_build/default/_doc/_html
+ build-object-store-opendal-doc:
+ runs-on: ubuntu-latest
+
+ steps:
+ - uses: actions/checkout@v4
+
+ - name: Setup Rust toolchain
+ uses: ./.github/actions/setup
+
+ # Revert to nightly after https://github.com/apache/opendal/issues/4161 addressed
+ - name: Setup Rust Nightly
+ run: |
+ rustup toolchain install nightly-2024-01-01
+
+ - name: Build object-store-opendal doc
+ working-directory: "integrations/object_store"
+ run: cargo +nightly-2024-01-01 doc --lib --no-deps --all-features
+ env:
+ # Enable cfg docs to make sure docs are built.
+ RUSTDOCFLAGS: "--cfg docs"
+
+ - name: Upload docs
+ uses: actions/upload-artifact@v3
+ with:
+ name: object-store-opendal-docs
+ path: ./integrations/object_store/target/doc
+
build-website:
runs-on: ubuntu-latest
needs:
@@ -304,6 +332,7 @@ jobs:
- build-haskell-doc
- build-cpp-doc
- build-ocaml-doc
+ - build-object-store-opendal-doc
steps:
- uses: actions/checkout@v4
@@ -376,6 +405,12 @@ jobs:
name: ocaml-docs
path: ./website/static/docs/ocaml
+ - name: Download object-store-opendal docs
+ uses: actions/download-artifact@v3
+ with:
+ name: object-store-opendal-docs
+ path: ./website/static/docs/object-store-opendal
+
- name: Install Dependencies
working-directory: website
run: pnpm install --frozen-lockfile
diff --git a/README.md b/README.md
index 81db309c7c..2836876a90 100644
--- a/README.md
+++ b/README.md
@@ -40,7 +40,7 @@ OpenDAL offers a unified data access layer, empowering users to seamlessly and e
| Name | Description | Release |
|---------------------------------------------------------------------|--------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|
| [dav-server-opendalfs](integrations/dav-server/README.md) | Access data via integrations to [dav-server-rs](https://github.com/messense/dav-server-rs) | [](https://crates.io/crates/dav-server-opendalfs) |
-| [object_store_opendal](integrations/object_store_opendal/README.md) | Access data via integrations to [object_store](https://docs.rs/object_store) | [](https://crates.io/crates/object_store_opendal) |
+| [object_store_opendal](integrations/object_store/README.md) | Access data via integrations to [object_store](https://docs.rs/object_store) | [](https://crates.io/crates/object_store_opendal) |
## For *ANY* services
diff --git a/website/docs/integrations/_category_.yml b/website/docs/integrations/_category_.yml
new file mode 100644
index 0000000000..d0564dc61a
--- /dev/null
+++ b/website/docs/integrations/_category_.yml
@@ -0,0 +1,24 @@
+# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements. See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership. The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License. You may obtain a copy of the License at
+#
+# http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied. See the License for the
+# specific language governing permissions and limitations
+# under the License.
+
+position: 5
+label: 'Integrations'
+collapsible: true
+collapsed: true
+link:
+ type: generated-index
+ title: Integrations
diff --git a/website/docs/integrations/object_store_opendal.mdx b/website/docs/integrations/object_store_opendal.mdx
new file mode 100644
index 0000000000..28f1c47483
--- /dev/null
+++ b/website/docs/integrations/object_store_opendal.mdx
@@ -0,0 +1,9 @@
+---
+title: object_store_opendal
+---
+
+[`object_store_opendal`](https://crates.io/crates/object_store_opendal) is an integration which uses OpenDAL as a backend for the [object_store](https://docs.rs/object_store/latest/object_store/).
+
+import Docs from '../../../integrations/object_store/README.md'
+
+<Docs components={props.components} />
diff --git a/website/docusaurus.config.js b/website/docusaurus.config.js
index 8fe2b4852b..4df38486cb 100644
--- a/website/docusaurus.config.js
+++ b/website/docusaurus.config.js
@@ -152,6 +152,10 @@ const config = {
label: 'Java Binding',
to: 'pathname:///docs/java/'
},
+ {
+ label: 'object-store-opendal',
+ to: 'pathname:///docs/object-store-opendal/object-store-opendal'
+ },
]
},
{