gaspersic/Gymnasium
1
0
Fork 0
mirror of https://github.com/Farama-Foundation/Gymnasium.git synced 2025-07-31 22:04:31 +00:00
Code Issues Packages Projects Releases Wiki Activity

Small fixes to docs (#724)

Browse Source
This commit is contained in:
Manuel Goulão
2023-09-25 13:56:30 +01:00
committed by GitHub
parent baf78078c3
commit 3e7ae6f5c9
5 changed files with 186 additions and 186 deletions
Download Patch File Download Diff File Expand all files Collapse all files

92
.github/workflows/build-docs.yml vendored
View File

@@ -1,46 +1,46 @@
name: Build main branch documentation website name: Build main branch documentation website
on: on:
push: push:
branches: [main] branches: [main]
permissions: permissions:
contents: write contents: write
jobs: jobs:
docs: docs:
name: Generate Website name: Generate Website
runs-on: ubuntu-latest runs-on: ubuntu-latest
env: env:
SPHINX_GITHUB_CHANGELOG_TOKEN: ${{ secrets.GITHUB_TOKEN }} SPHINX_GITHUB_CHANGELOG_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps: steps:
- uses: actions/checkout@v3 - uses: actions/checkout@v3
- uses: actions/setup-python@v4 - uses: actions/setup-python@v4
with: with:
python-version: '3.9' python-version: '3.9'
- name: Install dependencies - name: Install dependencies
run: pip install -r docs/requirements.txt run: pip install -r docs/requirements.txt
- name: Install Gymnasium - name: Install Gymnasium
run: pip install .[box2d,mujoco] run: pip install .[box2d,mujoco,jax] torch
- name: Build Envs Docs - name: Build Envs Docs
run: python docs/_scripts/gen_mds.py && python docs/_scripts/gen_envs_display.py run: python docs/_scripts/gen_mds.py && python docs/_scripts/gen_envs_display.py
- name: Build - name: Build
run: sphinx-build -b dirhtml -v docs _build run: sphinx-build -b dirhtml -v docs _build
- name: Move 404 - name: Move 404
run: mv _build/404/index.html _build/404.html run: mv _build/404/index.html _build/404.html
- name: Update 404 links - name: Update 404 links
run: python docs/_scripts/move_404.py _build/404.html run: python docs/_scripts/move_404.py _build/404.html
- name: Remove .doctrees - name: Remove .doctrees
run: rm -r _build/.doctrees run: rm -r _build/.doctrees
- name: Upload to GitHub Pages - name: Upload to GitHub Pages
uses: JamesIves/github-pages-deploy-action@v4 uses: JamesIves/github-pages-deploy-action@v4
with: with:
folder: _build folder: _build
target-folder: main target-folder: main
clean: false clean: false

142
.github/workflows/docs-manual-versioning.yml vendored
View File

@@ -1,71 +1,71 @@
name: Manual Docs Versioning name: Manual Docs Versioning
on: on:
workflow_dispatch: workflow_dispatch:
inputs: inputs:
version: version:
description: 'Documentation version to create' description: 'Documentation version to create'
required: true required: true
commit: commit:
description: 'Commit used to build the Documentation version' description: 'Commit used to build the Documentation version'
required: false required: false
latest: latest:
description: 'Latest version' description: 'Latest version'
type: boolean type: boolean
permissions: permissions:
contents: write contents: write
jobs: jobs:
docs: docs:
name: Generate Website for new version name: Generate Website for new version
runs-on: ubuntu-latest runs-on: ubuntu-latest
env: env:
SPHINX_GITHUB_CHANGELOG_TOKEN: ${{ secrets.GITHUB_TOKEN }} SPHINX_GITHUB_CHANGELOG_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps: steps:
- uses: actions/checkout@v3 - uses: actions/checkout@v3
if: inputs.commit == '' if: inputs.commit == ''
- uses: actions/checkout@v3 - uses: actions/checkout@v3
if: inputs.commit != '' if: inputs.commit != ''
with: with:
ref: ${{ inputs.commit }} ref: ${{ inputs.commit }}
- uses: actions/setup-python@v4 - uses: actions/setup-python@v4
with: with:
python-version: '3.9' python-version: '3.9'
- name: Install dependencies - name: Install dependencies
run: pip install -r docs/requirements.txt run: pip install -r docs/requirements.txt
- name: Install Gymnasium - name: Install Gymnasium
run: pip install .[box2d,mujoco] run: pip install .[box2d,mujoco,jax] torch
- name: Build Envs Docs - name: Build Envs Docs
run: python docs/_scripts/gen_mds.py && python docs/_scripts/gen_envs_display.py run: python docs/_scripts/gen_mds.py && python docs/_scripts/gen_envs_display.py
- name: Build - name: Build
run: sphinx-build -b dirhtml -v docs _build run: sphinx-build -b dirhtml -v docs _build
- name: Move 404 - name: Move 404
run: mv _build/404/index.html _build/404.html run: mv _build/404/index.html _build/404.html
- name: Update 404 links - name: Update 404 links
run: python docs/_scripts/move_404.py _build/404.html run: python docs/_scripts/move_404.py _build/404.html
- name: Remove .doctrees - name: Remove .doctrees
run: rm -r _build/.doctrees run: rm -r _build/.doctrees
- name: Upload to GitHub Pages - name: Upload to GitHub Pages
uses: JamesIves/github-pages-deploy-action@v4 uses: JamesIves/github-pages-deploy-action@v4
with: with:
folder: _build folder: _build
target-folder: ${{ inputs.version }} target-folder: ${{ inputs.version }}
clean: false clean: false
- name: Upload to GitHub Pages - name: Upload to GitHub Pages
uses: JamesIves/github-pages-deploy-action@v4 uses: JamesIves/github-pages-deploy-action@v4
if: inputs.latest if: inputs.latest
with: with:
folder: _build folder: _build
clean-exclude: | clean-exclude: |
*.*.*/ *.*.*/
main main

112
.github/workflows/docs-versioning.yml vendored
View File

@@ -1,56 +1,56 @@
name: Docs Versioning name: Docs Versioning
on: on:
push: push:
tags: tags:
- 'v?*.*.*' - 'v?*.*.*'
permissions: permissions:
contents: write contents: write
jobs: jobs:
docs: docs:
name: Generate Website for new version name: Generate Website for new version
runs-on: ubuntu-latest runs-on: ubuntu-latest
env: env:
SPHINX_GITHUB_CHANGELOG_TOKEN: ${{ secrets.GITHUB_TOKEN }} SPHINX_GITHUB_CHANGELOG_TOKEN: ${{ secrets.GITHUB_TOKEN }}
steps: steps:
- uses: actions/checkout@v3 - uses: actions/checkout@v3
- uses: actions/setup-python@v4 - uses: actions/setup-python@v4
with: with:
python-version: '3.9' python-version: '3.9'
- name: Install dependencies - name: Install dependencies
run: pip install -r docs/requirements.txt run: pip install -r docs/requirements.txt
- name: Install Gymnasium - name: Install Gymnasium
run: pip install .[box2d,mujoco] run: pip install .[box2d,mujoco,jax] torch
- name: Build Envs Docs - name: Build Envs Docs
run: python docs/_scripts/gen_mds.py && python docs/_scripts/gen_envs_display.py run: python docs/_scripts/gen_mds.py && python docs/_scripts/gen_envs_display.py
- name: Build - name: Build
run: sphinx-build -b dirhtml -v docs _build run: sphinx-build -b dirhtml -v docs _build
- name: Move 404 - name: Move 404
run: mv _build/404/index.html _build/404.html run: mv _build/404/index.html _build/404.html
- name: Update 404 links - name: Update 404 links
run: python docs/_scripts/move_404.py _build/404.html run: python docs/_scripts/move_404.py _build/404.html
- name: Remove .doctrees - name: Remove .doctrees
run: rm -r _build/.doctrees run: rm -r _build/.doctrees
- name: Upload to GitHub Pages - name: Upload to GitHub Pages
uses: JamesIves/github-pages-deploy-action@v4 uses: JamesIves/github-pages-deploy-action@v4
with: with:
folder: _build folder: _build
target-folder: ${{github.ref_name}} target-folder: ${{github.ref_name}}
clean: false clean: false
- name: Upload to GitHub Pages - name: Upload to GitHub Pages
uses: JamesIves/github-pages-deploy-action@v4 uses: JamesIves/github-pages-deploy-action@v4
if: ${{ !contains(github.ref_name, 'a') }} if: ${{ !contains(github.ref_name, 'a') }}
with: with:
folder: _build folder: _build
clean-exclude: | clean-exclude: |
*.*.*/ *.*.*/
main main

24
docs/api/experimental/functional.md
View File

@@ -7,23 +7,23 @@ title: Functional
## gymnasium.experimental.FuncEnv ## gymnasium.experimental.FuncEnv
```{eval-rst} ```{eval-rst}
.. autoclass:: gymnasium.experimental.FuncEnv .. autoclass:: gymnasium.experimental.functional.FuncEnv
.. autofunction:: gymnasium.experimental.FuncEnv.initial .. autofunction:: gymnasium.experimental.functional.FuncEnv.initial
.. autofunction:: gymnasium.experimental.FuncEnv.transition .. autofunction:: gymnasium.experimental.functional.FuncEnv.transition
.. autofunction:: gymnasium.experimental.FuncEnv.observation .. autofunction:: gymnasium.experimental.functional.FuncEnv.observation
.. autofunction:: gymnasium.experimental.FuncEnv.reward .. autofunction:: gymnasium.experimental.functional.FuncEnv.reward
.. autofunction:: gymnasium.experimental.FuncEnv.terminal .. autofunction:: gymnasium.experimental.functional.FuncEnv.terminal
.. autofunction:: gymnasium.experimental.FuncEnv.state_info .. autofunction:: gymnasium.experimental.functional.FuncEnv.state_info
.. autofunction:: gymnasium.experimental.FuncEnv.step_info .. autofunction:: gymnasium.experimental.functional.FuncEnv.step_info
.. autofunction:: gymnasium.experimental.FuncEnv.transform .. autofunction:: gymnasium.experimental.functional.FuncEnv.transform
.. autofunction:: gymnasium.experimental.FuncEnv.render_image .. autofunction:: gymnasium.experimental.functional.FuncEnv.render_image
.. autofunction:: gymnasium.experimental.FuncEnv.render_init .. autofunction:: gymnasium.experimental.functional.FuncEnv.render_init
.. autofunction:: gymnasium.experimental.FuncEnv.render_close .. autofunction:: gymnasium.experimental.functional.FuncEnv.render_close
``` ```
## gymnasium.experimental.func2env.FunctionalJaxCompatibilityEnv ## gymnasium.experimental.func2env.FunctionalJaxCompatibilityEnv

2
docs/requirements.txt
View File

@@ -1,7 +1,7 @@
sphinx sphinx
sphinx-autobuild sphinx-autobuild
myst-parser myst-parser
git+https://github.com/sphinx-gallery/sphinx-gallery.git@4006662c8c1984453a247dc6d3df6260e5b00f4b#egg=sphinx_gallery sphinx-gallery==0.14.0
git+https://github.com/Farama-Foundation/Celshast#egg=furo git+https://github.com/Farama-Foundation/Celshast#egg=furo
moviepy moviepy
pygame pygame