2023-07-21 16:20:24 +00:00
|
|
|
.PHONY: all clean docs_build docs_clean docs_linkcheck api_docs_build api_docs_clean api_docs_linkcheck
|
2022-10-24 21:51:15 +00:00
|
|
|
|
2023-07-12 01:03:17 +00:00
|
|
|
# Default target executed when no arguments are given to make.
|
2023-02-14 05:08:47 +00:00
|
|
|
all: help
|
2023-04-01 16:00:09 +00:00
|
|
|
|
2022-12-13 13:48:53 +00:00
|
|
|
|
Fix `make docs_build` and related scripts (#7276)
**Description: a description of the change**
Fixed `make docs_build` and related scripts which caused errors. There
are several changes.
First, I made the build of the documentation and the API Reference into
two separate commands. This is because it takes less time to build. The
commands for documents are `make docs_build`, `make docs_clean`, and
`make docs_linkcheck`. The commands for API Reference are `make
api_docs_build`, `api_docs_clean`, and `api_docs_linkcheck`.
It looked like `docs/.local_build.sh` could be used to build the
documentation, so I used that. Since `.local_build.sh` was also building
API Rerefence internally, I removed that process. `.local_build.sh` also
added some Bash options to stop in error or so. Futher more added `cd
"${SCRIPT_DIR}"` at the beginning so that the script will work no matter
which directory it is executed in.
`docs/api_reference/api_reference.rst` is removed, because which is
generated by `docs/api_reference/create_api_rst.py`, and added it to
.gitignore.
Finally, the description of CONTRIBUTING.md was modified.
**Issue: the issue # it fixes (if applicable)**
https://github.com/hwchase17/langchain/issues/6413
**Dependencies: any dependencies required for this change**
`nbdoc` was missing in group docs so it was added. I installed it with
the `poetry add --group docs nbdoc` command. I am concerned if any
modifications are needed to poetry.lock. I would greatly appreciate it
if you could pay close attention to this file during the review.
**Tag maintainer**
- General / Misc / if you don't know who to tag: @baskaryan
If this PR needs any additional changes, I'll be happy to make them!
---------
Co-authored-by: Bagatur <baskaryan@gmail.com>
2023-07-12 02:05:14 +00:00
|
|
|
######################
|
|
|
|
# DOCUMENTATION
|
|
|
|
######################
|
|
|
|
|
|
|
|
clean: docs_clean api_docs_clean
|
|
|
|
|
|
|
|
|
|
|
|
docs_build:
|
|
|
|
docs/.local_build.sh
|
|
|
|
|
|
|
|
docs_clean:
|
|
|
|
rm -r docs/_dist
|
|
|
|
|
|
|
|
docs_linkcheck:
|
|
|
|
poetry run linkchecker docs/_dist/docs_skeleton/ --ignore-url node_modules
|
|
|
|
|
|
|
|
api_docs_build:
|
|
|
|
poetry run python docs/api_reference/create_api_rst.py
|
|
|
|
cd docs/api_reference && poetry run make html
|
|
|
|
|
|
|
|
api_docs_clean:
|
|
|
|
rm -f docs/api_reference/api_reference.rst
|
|
|
|
cd docs/api_reference && poetry run make clean
|
|
|
|
|
|
|
|
api_docs_linkcheck:
|
|
|
|
poetry run linkchecker docs/api_reference/_build/html/index.html
|
|
|
|
|
2023-07-12 20:20:08 +00:00
|
|
|
spell_check:
|
|
|
|
poetry run codespell --toml pyproject.toml
|
|
|
|
|
|
|
|
spell_fix:
|
|
|
|
poetry run codespell --toml pyproject.toml -w
|
|
|
|
|
2023-07-12 01:03:17 +00:00
|
|
|
######################
|
|
|
|
# HELP
|
|
|
|
######################
|
2023-04-01 16:00:09 +00:00
|
|
|
|
2023-02-14 05:08:47 +00:00
|
|
|
help:
|
2023-09-22 17:17:08 +00:00
|
|
|
@echo '===================='
|
|
|
|
@echo '-- DOCUMENTATION --'
|
2023-08-04 19:37:00 +00:00
|
|
|
@echo 'clean - run docs_clean and api_docs_clean'
|
2023-05-10 13:39:22 +00:00
|
|
|
@echo 'docs_build - build the documentation'
|
|
|
|
@echo 'docs_clean - clean the documentation build artifacts'
|
|
|
|
@echo 'docs_linkcheck - run linkchecker on the documentation'
|
2023-08-04 19:37:00 +00:00
|
|
|
@echo 'api_docs_build - build the API Reference documentation'
|
|
|
|
@echo 'api_docs_clean - clean the API Reference documentation build artifacts'
|
|
|
|
@echo 'api_docs_linkcheck - run linkchecker on the API Reference documentation'
|
|
|
|
@echo 'spell_check - run codespell on the project'
|
2023-09-22 17:17:08 +00:00
|
|
|
@echo 'spell_fix - run codespell on the project and fix the errors'
|
|
|
|
@echo '-- TEST and LINT tasks are within libs/*/ per-package --'
|