Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

CHORE: Cleanup repository #230

Draft
wants to merge 11 commits into
base: main
Choose a base branch
from
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 9 additions & 62 deletions .github/workflows/ci_cd.yml
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ jobs:
name: Documentation style
runs-on: ubuntu-latest
steps:
- uses: ansys/actions/doc-style@v4
- uses: ansys/actions/doc-style@v7
with:
token: ${{ secrets.GITHUB_TOKEN }}

Expand All @@ -42,77 +42,24 @@ jobs:
name: Build documentation
runs-on: [self-hosted, Windows, pyaedt-examples]
steps:
- uses: actions/checkout@v4

- name: Set up Python ${{ env.MAIN_PYTHON_VERSION }}
uses: actions/setup-python@v4
with:
python-version: ${{ env.MAIN_PYTHON_VERSION }}

- name: Create virtual environment
run: |
python -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install pip -U
python -m pip install wheel setuptools -U
python -c "import sys; print(sys.executable)"

- name: Install project and documentation dependencies
run: |
.venv\Scripts\Activate.ps1
pip install --no-cache-dir -r requirements/requirements_doc.txt

# Use environment variable speed up build for PDF pages
- name: Create HTML documentation
env:
SPHINXBUILD_HTML_AND_PDF_WORKFLOW: "1"
run: |
.venv\Scripts\Activate.ps1
. .\doc\make.bat html --color

# NOTE: Ugly HTML checking but redirecting errors with our docs either leads
# to errors in powershell or workflows getting stuck in Github CICD.
- name: Check HTML doc creation
run : |
if (Test-Path "doc\_build\html\index.html" ) {
Write-Output "File index.html found, HTML build successful."
} else {
Write-Error "Sphinx build failed, check if there is no cell execution error."
exit 1
}

- name: Upload HTML documentation artifact
uses: actions/upload-artifact@v4
with:
name: documentation-html
path: doc/_build/html
retention-days: 7

# Use environment variable to remove the doctree after the build of PDF pages
# Keeping doctree could cause an issue, see https://github.com/ansys/pyaedt/pull/3844/files
- name: Create PDF documentation
- name: Build documentation
uses: ansys/actions/doc-build@fix/inconsistent-behavior
env:
SPHINXBUILD_HTML_AND_PDF_WORKFLOW: "1"
run: |
.venv\Scripts\Activate.ps1
. .\doc\make.bat pdf

- name: Upload PDF documentation artifact
uses: actions/upload-artifact@v4
with:
name: documentation-pdf
path: doc/_build/latex
retention-days: 7

python-version: ${{ env.MAIN_PYTHON_VERSION }}
check-links: false
use-python-cache: false
skip-install: true

deploy-doc:
name: Upload documentation
if: contains(github.ref, 'refs/heads/main')
runs-on: ubuntu-latest
needs: [doc-build]
steps:
- name: Deploy the documentation
uses: ansys/actions/doc-deploy-dev@v5
uses: ansys/actions/doc-deploy-dev@v7
with:
cname: ${{ env.DOCUMENTATION_CNAME }}
token: ${{ secrets.GITHUB_TOKEN }}
doc-artifact-name: 'documentation-html'
2 changes: 1 addition & 1 deletion .pre-commit-config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ repos:
rev: v2.2.6
hooks:
- id: codespell
args: ["--ignore-words", "doc/styles/Vocab/ANSYS/accept.txt", "-w"]
args: ["--ignore-words=doc/styles/config/vocabularies/ANSYS/accept.txt", "-w"]
exclude: >
(?x)^(
.*\.css
Expand Down
3 changes: 3 additions & 0 deletions doc/.vale.ini
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,9 @@ Vocab = ANSYS
# Apply the following styles
BasedOnStyles = Vale, Google

# Remove vale terms
Vale.Terms = NO

# Removing Google-specific rule - Not applicable under some circumstances
Google.WordList = NO
Google.Colons = NO
Binary file removed doc/source/Resources/3dlayout.png
Binary file not shown.
Binary file removed doc/source/Resources/3dlayout_1.png
Binary file not shown.
Binary file removed doc/source/Resources/5gantenna.png
Binary file not shown.
Binary file removed doc/source/Resources/BlankDiagram3DLayout.png
Binary file not shown.
Binary file removed doc/source/Resources/BlankDiagram3DModeler.png
Binary file not shown.
Binary file removed doc/source/Resources/BlankDiagramCircuit.png
Binary file not shown.
Binary file removed doc/source/Resources/Dipole.png
Binary file not shown.
Binary file removed doc/source/Resources/IronPython2Cpython.png
Binary file not shown.
Binary file removed doc/source/Resources/Items.png
Binary file not shown.
Binary file removed doc/source/Resources/Maxwell3DTeam3.png
Binary file not shown.
Binary file removed doc/source/Resources/Mesh_Operations.png
Binary file not shown.
Binary file removed doc/source/Resources/Optimetrics_Parametric.png
Binary file not shown.
Binary file removed doc/source/Resources/Setups.png
Binary file not shown.
Binary file removed doc/source/Resources/Sherlock.png
Binary file not shown.
Binary file removed doc/source/Resources/aedt_2.png
Binary file not shown.
Binary file removed doc/source/Resources/aedt_3.png
Binary file not shown.
Binary file removed doc/source/Resources/aedt_box.png
Binary file not shown.
Binary file removed doc/source/Resources/aedt_first_page.png
Binary file not shown.
Binary file removed doc/source/Resources/aedt_setup.png
Binary file not shown.
Binary file removed doc/source/Resources/aedt_variables.png
Binary file not shown.
Binary file removed doc/source/Resources/array.png
Binary file not shown.
44 changes: 0 additions & 44 deletions doc/source/Resources/array_example.json

This file was deleted.

Binary file removed doc/source/Resources/busbar.png
Binary file not shown.
170 changes: 0 additions & 170 deletions doc/source/Resources/cable_example.json

This file was deleted.

Loading
Loading