| # Copyright 2022 GlobalFoundries PDK Authors |
| # |
| # Licensed 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 |
| # |
| # https://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. |
| # |
| # SPDX-License-Identifier: Apache-2.0 |
| |
| # |
| # Configuration file for the Sphinx documentation builder. |
| # |
| # This file does only contain a selection of the most common options. For a |
| # full list see the documentation: |
| # http://www.sphinx-doc.org/en/master/config |
| |
| # -- Path setup -------------------------------------------------------------- |
| |
| # If extensions (or modules to document with autodoc) are in another directory, |
| # add these directories to sys.path here. If the directory is relative to the |
| # documentation root, use os.path.abspath to make it absolute, like shown here. |
| # |
| |
| #========================================================================= |
| # ---------------------------------- DOCS -------------------------------- |
| #========================================================================= |
| |
| theme_link ="https://github.com/f4pga/sphinx_f4pga_theme" |
| |
| |
| .DEFAULT_GOAL := docs |
| |
| |
| docs: build display |
| |
| |
| #======================== |
| # ---- Dependiencies ---- |
| #======================== |
| |
| .ONESHELL: |
| install-theme: |
| @cd docs/ |
| @rm -rf sphinx_f4pga_theme |
| @git clone $(theme_link) |
| @cd sphinx_f4pga_theme |
| @python setup.py install |
| |
| |
| #======================== |
| # ----- BUILD DOCS ------ |
| #======================== |
| |
| .ONESHELL: |
| build: install-theme |
| @cd docs/ |
| @pip install -r requirements.txt |
| @make html |
| |
| #======================== |
| # ---- DISPLAY DOCS ----- |
| #======================== |
| |
| .ONESHELL: |
| display: build |
| @cd docs/_build/html |
| @xdg-open index.html |