prepare space for fused docs (#14160)

* copy app conf

* ci + req.

* script symlink

* wip

* keep only App

* add also PL

* lightning

* artifact
This commit is contained in:
Jirka Borovec 2022-08-30 15:25:05 +02:00 committed by GitHub
parent 7987a1b453
commit 208bf6faa8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
433 changed files with 1204 additions and 6 deletions

View File

@ -17,7 +17,7 @@ jobs:
strategy:
fail-fast: false
matrix:
pkg: ["app", "pytorch"]
pkg: ["app", "pytorch"] # TODO: , "lit"
steps:
- uses: actions/checkout@v2
with:
@ -68,7 +68,7 @@ jobs:
strategy:
fail-fast: false
matrix:
pkg: ["app", "pytorch"]
pkg: ["app", "pytorch", "lit"]
steps:
- uses: actions/checkout@v2
with:
@ -112,7 +112,7 @@ jobs:
- name: Upload built docs
uses: actions/upload-artifact@v3
with:
name: docs-results-${{ github.sha }}
name: docs-${{ matrix.pkg }}-${{ github.sha }}
path: docs/build/html/
# Use always() to always run this step to publish test results when there are test failures
if: success()

3
.gitignore vendored
View File

@ -9,6 +9,9 @@ lightning_logs/
# Documentations
docs/source-app/generated
docs/source-app/*/generated
docs/source-lit/generated
docs/source-lit/*/generated
docs/source-lit/api
docs/source-pytorch/api
docs/source-pytorch/*.md
docs/source-pytorch/generated

View File

@ -22,6 +22,9 @@ clean:
rm -rf ./docs/source-pytorch/api
rm -rf ./docs/source-app/generated
rm -rf ./docs/source-app/*/generated
rm -rf ./docs/source-lit/api
rm -rf ./docs/source-lit/generated
rm -rf ./docs/source-lit/*/generated
rm -rf build
rm -rf dist
rm -rf *.egg-info

27
docs/create-symlinks.py Normal file
View File

@ -0,0 +1,27 @@
import glob
import os
def symlink_folder(source_dir, target_dir: str = "source-lit") -> None:
assert os.path.isdir(source_dir)
assert os.path.isdir(target_dir)
ls = glob.glob(os.path.join(source_dir, "**"), recursive=True)
for path_ in ls:
path_target = path_.replace(source_dir, target_dir)
if os.path.isdir(path_) or os.path.exists(path_target):
continue
if os.path.islink(path_target):
print(path_target)
continue
path_dir = os.path.dirname(path_target)
os.makedirs(path_dir, exist_ok=True)
depth = path_.count(os.path.sep)
path_root = os.path.sep.join([".."] * depth)
path_source = os.path.join(path_root, path_)
# print(path_source, path_target, os.path.exists(path_target))
os.symlink(path_source, path_target)
if __name__ == "__main__":
for name in ("app", "pytorch"):
symlink_folder(f"source-{name}")

View File

@ -1,6 +1,5 @@
from docs.quickstart.app_02 import HourLongWork
import lightning as L
from docs.quickstart.app_02 import HourLongWork
class RootFlow(L.LightningFlow):

19
docs/source-lit/Makefile Normal file
View File

@ -0,0 +1,19 @@
# Minimal makefile for Sphinx documentation
#
# You can set these variables from the command line.
SPHINXOPTS = -T -W
SPHINXBUILD = sphinx-build
SOURCEDIR = .
BUILDDIR = ../build
# Put it first so that "make" without argument is like "make help".
help:
@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
.PHONY: help Makefile
# Catch-all target: route all unknown targets to Sphinx using the new
# "make mode" option. $(O) is meant as a shortcut for $(SPHINXOPTS).
%: Makefile
@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

View File

@ -0,0 +1 @@
../../source-app/_static/copybutton.js

View File

@ -0,0 +1 @@
../../../../../source-pytorch/_static/images/accelerator/ipus/profiler.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/benchmarks/figure-parity-times.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/general/PTL101_youtube_thumbnail.jpg

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/general/fast_2.gif

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/general/pl_overview.gif

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/general/pl_overview_flat.jpg

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/general/pl_quick_start_full_compressed.gif

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/general/tf_loss.jpg

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/general/tf_tags.jpg

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/general/tutorial_cover.jpg

View File

@ -0,0 +1 @@
../../../source-app/_static/images/icon.svg

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/lightning_lite/lite.gif

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/lightning_module/pt_to_pl.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/lightning_module/pt_trainer.png

View File

@ -0,0 +1 @@
../../../source-app/_static/images/logo-large.svg

View File

@ -0,0 +1 @@
../../../source-app/_static/images/logo-small.svg

View File

@ -0,0 +1 @@
../../../source-app/_static/images/logo.png

View File

@ -0,0 +1 @@
../../../source-app/_static/images/logo.svg

View File

@ -0,0 +1 @@
../../../source-pytorch/_static/images/logo_light.svg

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/mnist_imgs/mnist_cpu_bar.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/mnist_imgs/mnist_gpu.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/mnist_imgs/mnist_tb.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/mnist_imgs/pt_to_pl.jpg

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/mnist_imgs/restart_runtime.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/mnist_imgs/runtime_tpu.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/mnist_imgs/tpu_fast.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/mnist_imgs/tpu_start.png

View File

@ -0,0 +1 @@
../../../../source-pytorch/_static/images/trainer/lr_finder.png

View File

@ -0,0 +1 @@
../../source-app/_static/main.css

View File

@ -0,0 +1 @@
../../../source-pytorch/_templates/autosummary/module.rst

View File

@ -0,0 +1 @@
../../source-app/_templates/classtemplate.rst

View File

@ -0,0 +1 @@
../../source-app/_templates/classtemplate_no_index.rst

View File

@ -0,0 +1 @@
../../source-app/_templates/layout.html

View File

@ -0,0 +1 @@
../../source-app/_templates/theme_variables.jinja

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/accelerator_prepare.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/gpu.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/gpu_advanced.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/gpu_basic.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/gpu_expert.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/gpu_faq.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/gpu_intermediate.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/hpu.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/hpu_basic.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/hpu_intermediate.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/ipu.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/ipu_advanced.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/ipu_basic.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/ipu_intermediate.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/mps.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/mps_basic.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/tpu.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/tpu_advanced.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/tpu_basic.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/tpu_faq.rst

View File

@ -0,0 +1 @@
../../source-pytorch/accelerators/tpu_intermediate.rst

View File

@ -0,0 +1 @@
../../source-pytorch/advanced/finetuning.rst

View File

@ -0,0 +1 @@
../../source-pytorch/advanced/model_parallel.rst

View File

@ -0,0 +1 @@
../../source-pytorch/advanced/pretrained.rst

View File

@ -0,0 +1 @@
../../source-pytorch/advanced/pruning_quantization.rst

View File

@ -0,0 +1 @@
../../source-pytorch/advanced/strategy_registry.rst

View File

@ -0,0 +1 @@
../../source-pytorch/advanced/training_tricks.rst

View File

@ -0,0 +1 @@
../../source-pytorch/advanced/transfer_learning.rst

View File

@ -0,0 +1 @@
../../source-app/api_reference/components.rst

View File

@ -0,0 +1 @@
../../source-app/api_reference/core.rst

View File

@ -0,0 +1 @@
../../source-app/api_reference/frontend.rst

View File

@ -0,0 +1 @@
../../source-app/api_reference/runners.rst

View File

@ -0,0 +1 @@
../../source-app/api_reference/storage.rst

View File

@ -0,0 +1 @@
../source-app/api_references.rst

1
docs/source-lit/basics.rst Symbolic link
View File

@ -0,0 +1 @@
../source-app/basics.rst

View File

@ -0,0 +1 @@
../../source-pytorch/benchmarking/benchmarks.rst

View File

@ -0,0 +1 @@
../../source-pytorch/cli/lightning_cli.rst

View File

@ -0,0 +1 @@
../../source-pytorch/cli/lightning_cli_advanced.rst

View File

@ -0,0 +1 @@
../../source-pytorch/cli/lightning_cli_advanced_2.rst

View File

@ -0,0 +1 @@
../../source-pytorch/cli/lightning_cli_advanced_3.rst

View File

@ -0,0 +1 @@
../../source-pytorch/cli/lightning_cli_expert.rst

View File

@ -0,0 +1 @@
../../source-pytorch/cli/lightning_cli_faq.rst

View File

@ -0,0 +1 @@
../../source-pytorch/cli/lightning_cli_intermediate.rst

View File

@ -0,0 +1 @@
../../source-pytorch/cli/lightning_cli_intermediate_2.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/cloud_training.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/cloud_training_intermediate.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/cluster.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/cluster_advanced.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/cluster_expert.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/cluster_intermediate_1.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/cluster_intermediate_2.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/fault_tolerant_training.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/fault_tolerant_training_basic.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/fault_tolerant_training_expert.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/fault_tolerant_training_faq.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/grid_costs.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/run_advanced.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/run_basic.rst

View File

@ -0,0 +1 @@
../../source-pytorch/clouds/run_expert.rst

Some files were not shown because too many files have changed in this diff Show More