From a17baf3717ba8cf90dacf07893073cf2883c2fbf Mon Sep 17 00:00:00 2001 From: shiyz Date: Sun, 25 Jun 2023 11:18:02 +0800 Subject: [PATCH 1/9] add chinese translation to index --- docs/2.0/documentation/index.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 docs/2.0/documentation/index.md diff --git a/docs/2.0/documentation/index.md b/docs/2.0/documentation/index.md new file mode 100644 index 000000000..4dc43be50 --- /dev/null +++ b/docs/2.0/documentation/index.md @@ -0,0 +1,11 @@ +# PyTorch 文档 + +PyTorch 是一个针对深度学习，基于 GPU 和 CPU 的优化张量库。 + +本文档中描述的功能按发布状态分类： + + *稳定版:* 这些功能将长期维护，并且文档中通常不会有主要性能限制或差距。我们还希望保持向后兼容性（尽管可能会发生破坏性更改，但是会提前一个版本会给出通知）。 + + *Beta 版:* 这些功能被标记为 Beta 版，因为 API 可能会根据用户反馈而更改，因为性能需要改进，或者因为操作覆盖范围尚不完整。对于 Beta 版功能，我们承诺将该功能推进到稳定版。但是，我们不承诺向后兼容性。 + + *原型版:* 这些功能通常不作为 PyPI 或 Conda 等二进制发行版的一部分提供，除非有时在运行时标志后面，并且处于反馈和测试的早期阶段。 From d4a93315cf53112e3bdc2e38357f07f1879f9195 Mon Sep 17 00:00:00 2001 From: shiyz Date: Sun, 25 Jun 2023 11:21:04 +0800 Subject: [PATCH 2/9] add chinese translate to index --- docs/2.0/documentation/index.rst | 164 +++++++++++++++++++++++++++++++ 1 file changed, 164 insertions(+) create mode 100644 docs/2.0/documentation/index.rst diff --git a/docs/2.0/documentation/index.rst b/docs/2.0/documentation/index.rst new file mode 100644 index 000000000..5fa261e77 --- /dev/null +++ b/docs/2.0/documentation/index.rst @@ -0,0 +1,164 @@ +.. PyTorch documentation master file, created by + sphinx-quickstart on Fri Dec 23 13:31:47 2016. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +:github_url: https://github.com/pytorch/pytorch + +PyTorch documentation +=================================== + +PyTorch is an optimized tensor library for deep learning using GPUs and CPUs. + +Features described in this documentation are classified by release status: + + *Stable:* These features will be maintained long-term and there should generally + be no major performance limitations or gaps in documentation. + We also expect to maintain backwards compatibility (although + breaking changes can happen and notice will be given one release ahead + of time). + + *Beta:* These features are tagged as Beta because the API may change based on + user feedback, because the performance needs to improve, or because + coverage across operators is not yet complete. For Beta features, we are + committing to seeing the feature through to the Stable classification. + We are not, however, committing to backwards compatibility. + + *Prototype:* These features are typically not available as part of + binary distributions like PyPI or Conda, except sometimes behind run-time + flags, and are at an early stage for feedback and testing. + +.. toctree:: + :glob: + :maxdepth: 1 + :caption: Community + + community/* + +.. toctree:: + :glob: + :maxdepth: 1 + :caption: Developer Notes + + notes/* + +.. toctree:: + :glob: + :maxdepth: 1 + :caption: torch.compile + + compile/index + compile/get-started + compile/troubleshooting + compile/faq + compile/technical-overview + compile/guards-overview + compile/custom-backends + compile/fine_grained_apis + compile/profiling_torch_compile + compile/inductor_profiling + compile/deep-dive + compile/cudagraph_trees + compile/performance-dashboard + compile/torchfunc-and-torchcompile + ir + compile/dynamic-shapes + compile/fake-tensor + logging + compile/transformations + +.. toctree:: + :maxdepth: 1 + :caption: Language Bindings + + cpp_index + Javadoc + torch::deploy + +.. toctree:: + :glob: + :maxdepth: 2 + :caption: Python API + + torch + nn + nn.functional + tensors + tensor_attributes + tensor_view + torch.amp + torch.autograd + torch.library + cuda + mps + torch.backends + torch.distributed + torch.distributed.algorithms.join + torch.distributed.elastic + torch.distributed.fsdp + torch.distributed.optim + torch.distributed.tensor.parallel + torch.distributed.checkpoint + torch.distributions + torch.compiler + torch.fft + torch.func + futures + fx + torch.hub + torch.jit + torch.linalg + torch.monitor + torch.signal + torch.special + torch.overrides + torch.package + profiler + nn.init + onnx + onnx_diagnostics + optim + complex_numbers + ddp_comm_hooks + pipeline + quantization + rpc + torch.random + masked + torch.nested + sparse + storage + torch.testing + torch.utils.benchmark + torch.utils.bottleneck + torch.utils.checkpoint + torch.utils.cpp_extension + torch.utils.data + torch.utils.jit + torch.utils.dlpack + torch.utils.mobile_optimizer + torch.utils.model_zoo + torch.utils.tensorboard + type_info + named_tensor + name_inference + torch.__config__ + logging + +.. toctree:: + :maxdepth: 1 + :caption: Libraries + + torchaudio + TorchData + TorchRec + TorchServe + torchtext + torchvision + PyTorch on XLA Devices + +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` \ No newline at end of file From 55247cad652a74f7bdb5645e23fc0ace32228f8a Mon Sep 17 00:00:00 2001 From: shiyz Date: Sun, 25 Jun 2023 11:27:38 +0800 Subject: [PATCH 3/9] remove origin rst file --- docs/2.0/documentation/index.rst | 164 ------------------------------- 1 file changed, 164 deletions(-) delete mode 100644 docs/2.0/documentation/index.rst diff --git a/docs/2.0/documentation/index.rst b/docs/2.0/documentation/index.rst deleted file mode 100644 index 5fa261e77..000000000 --- a/docs/2.0/documentation/index.rst +++ /dev/null @@ -1,164 +0,0 @@ -.. PyTorch documentation master file, created by - sphinx-quickstart on Fri Dec 23 13:31:47 2016. - You can adapt this file completely to your liking, but it should at least - contain the root `toctree` directive. - -:github_url: https://github.com/pytorch/pytorch - -PyTorch documentation -=================================== - -PyTorch is an optimized tensor library for deep learning using GPUs and CPUs. - -Features described in this documentation are classified by release status: - - *Stable:* These features will be maintained long-term and there should generally - be no major performance limitations or gaps in documentation. - We also expect to maintain backwards compatibility (although - breaking changes can happen and notice will be given one release ahead - of time). - - *Beta:* These features are tagged as Beta because the API may change based on - user feedback, because the performance needs to improve, or because - coverage across operators is not yet complete. For Beta features, we are - committing to seeing the feature through to the Stable classification. - We are not, however, committing to backwards compatibility. - - *Prototype:* These features are typically not available as part of - binary distributions like PyPI or Conda, except sometimes behind run-time - flags, and are at an early stage for feedback and testing. - -.. toctree:: - :glob: - :maxdepth: 1 - :caption: Community - - community/* - -.. toctree:: - :glob: - :maxdepth: 1 - :caption: Developer Notes - - notes/* - -.. toctree:: - :glob: - :maxdepth: 1 - :caption: torch.compile - - compile/index - compile/get-started - compile/troubleshooting - compile/faq - compile/technical-overview - compile/guards-overview - compile/custom-backends - compile/fine_grained_apis - compile/profiling_torch_compile - compile/inductor_profiling - compile/deep-dive - compile/cudagraph_trees - compile/performance-dashboard - compile/torchfunc-and-torchcompile - ir - compile/dynamic-shapes - compile/fake-tensor - logging - compile/transformations - -.. toctree:: - :maxdepth: 1 - :caption: Language Bindings - - cpp_index - Javadoc - torch::deploy - -.. toctree:: - :glob: - :maxdepth: 2 - :caption: Python API - - torch - nn - nn.functional - tensors - tensor_attributes - tensor_view - torch.amp - torch.autograd - torch.library - cuda - mps - torch.backends - torch.distributed - torch.distributed.algorithms.join - torch.distributed.elastic - torch.distributed.fsdp - torch.distributed.optim - torch.distributed.tensor.parallel - torch.distributed.checkpoint - torch.distributions - torch.compiler - torch.fft - torch.func - futures - fx - torch.hub - torch.jit - torch.linalg - torch.monitor - torch.signal - torch.special - torch.overrides - torch.package - profiler - nn.init - onnx - onnx_diagnostics - optim - complex_numbers - ddp_comm_hooks - pipeline - quantization - rpc - torch.random - masked - torch.nested - sparse - storage - torch.testing - torch.utils.benchmark - torch.utils.bottleneck - torch.utils.checkpoint - torch.utils.cpp_extension - torch.utils.data - torch.utils.jit - torch.utils.dlpack - torch.utils.mobile_optimizer - torch.utils.model_zoo - torch.utils.tensorboard - type_info - named_tensor - name_inference - torch.__config__ - logging - -.. toctree:: - :maxdepth: 1 - :caption: Libraries - - torchaudio - TorchData - TorchRec - TorchServe - torchtext - torchvision - PyTorch on XLA Devices - -Indices and tables -================== - -* :ref:`genindex` -* :ref:`modindex` \ No newline at end of file From 7dae2ea014966932147f79c47b52f457d32fbedc Mon Sep 17 00:00:00 2001 From: shiyz Date: Sun, 25 Jun 2023 14:39:12 +0800 Subject: [PATCH 4/9] rename the index --- docs/2.0/documentation/{index.md => README.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/2.0/documentation/{index.md => README.md} (100%) diff --git a/docs/2.0/documentation/index.md b/docs/2.0/documentation/README.md similarity index 100% rename from docs/2.0/documentation/index.md rename to docs/2.0/documentation/README.md From 57e02ce44c8001161e7ce95ed12c81a985317fe4 Mon Sep 17 00:00:00 2001 From: shiyz Date: Sun, 25 Jun 2023 14:40:09 +0800 Subject: [PATCH 5/9] rename the dir --- docs/2.0/{documentation => docs}/README.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename docs/2.0/{documentation => docs}/README.md (100%) diff --git a/docs/2.0/documentation/README.md b/docs/2.0/docs/README.md similarity index 100% rename from docs/2.0/documentation/README.md rename to docs/2.0/docs/README.md From aafd8c8586c2b9b823ef0dab26bb0e8d9b5b15a6 Mon Sep 17 00:00:00 2001 From: shiyz Date: Sun, 25 Jun 2023 14:51:46 +0800 Subject: [PATCH 6/9] add author and url --- docs/2.0/docs/README.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/2.0/docs/README.md b/docs/2.0/docs/README.md index 4dc43be50..df9278658 100644 --- a/docs/2.0/docs/README.md +++ b/docs/2.0/docs/README.md @@ -1,5 +1,11 @@ # PyTorch 文档 +> 译者：[LordQ](https://github.com/lordqyxz) +> +> 项目地址： +> +> 原始地址： + PyTorch 是一个针对深度学习，基于 GPU 和 CPU 的优化张量库。 本文档中描述的功能按发布状态分类： From 1740af5dc814477b58b72b8a2d6ebba43ecc0ced Mon Sep 17 00:00:00 2001 From: shiyz Date: Sun, 25 Jun 2023 15:30:54 +0800 Subject: [PATCH 7/9] =?UTF-8?q?add=20nav=20=E8=B7=AF=E5=BE=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- mkdocs.yml | 2 ++ 1 file changed, 2 insertions(+) diff --git a/mkdocs.yml b/mkdocs.yml index 826ef40e9..f33133f0e 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -28,6 +28,8 @@ extra_javascript: nav: - "PyTorch 中文文档 & 教程": "index.md" + - "PyTorch 2.0 中文文档 & 教程": + - "中文文档": "2.0/docs/README.md" - "PyTorch 1.7 中文文档": - "学习 PyTorch": - "PyTorch 深度学习：60 分钟的突击": From c4cc0a8e09cc06954d953f72acdb96fa7d9a2c62 Mon Sep 17 00:00:00 2001 From: shiyz Date: Sun, 25 Jun 2023 15:38:09 +0800 Subject: [PATCH 8/9] =?UTF-8?q?=E8=B0=83=E6=95=B4=E6=A0=B7=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/2.0/docs/README.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/2.0/docs/README.md b/docs/2.0/docs/README.md index df9278658..bd2d92480 100644 --- a/docs/2.0/docs/README.md +++ b/docs/2.0/docs/README.md @@ -10,8 +10,8 @@ PyTorch 是一个针对深度学习，基于 GPU 和 CPU 的优化张量库。 本文档中描述的功能按发布状态分类： - *稳定版:* 这些功能将长期维护，并且文档中通常不会有主要性能限制或差距。我们还希望保持向后兼容性（尽管可能会发生破坏性更改，但是会提前一个版本会给出通知）。 - - *Beta 版:* 这些功能被标记为 Beta 版，因为 API 可能会根据用户反馈而更改，因为性能需要改进，或者因为操作覆盖范围尚不完整。对于 Beta 版功能，我们承诺将该功能推进到稳定版。但是，我们不承诺向后兼容性。 - - *原型版:* 这些功能通常不作为 PyPI 或 Conda 等二进制发行版的一部分提供，除非有时在运行时标志后面，并且处于反馈和测试的早期阶段。 +- *稳定版:* 这些功能将长期维护，并且文档中通常不会有主要性能限制或差距。我们还希望保持向后兼容性（尽管可能会发生破坏性更改，但是会提前一个版本会给出通知）。 + +- *Beta 版:* 这些功能被标记为 Beta 版，因为 API 可能会根据用户反馈而更改，因为性能需要改进，或者因为操作覆盖范围尚不完整。对于 Beta 版功能，我们承诺将该功能推进到稳定版。但是，我们不承诺向后兼容性。 + +- *原型版:* 这些功能通常不作为 PyPI 或 Conda 等二进制发行版的一部分提供，除非有时在运行时标志后面，并且处于反馈和测试的早期阶段。 From 987cdccddb3b9199f38434420efecf7e4598aae7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=89=87=E5=88=BB?= Date: Sun, 25 Jun 2023 15:58:16 +0800 Subject: [PATCH 9/9] =?UTF-8?q?Update=202.0=E7=9B=AE=E5=BD=95=E7=BB=93?= =?UTF-8?q?=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- mkdocs.yml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/mkdocs.yml b/mkdocs.yml index f33133f0e..a3a078704 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -29,7 +29,10 @@ extra_javascript: nav: - "PyTorch 中文文档 & 教程": "index.md" - "PyTorch 2.0 中文文档 & 教程": - - "中文文档": "2.0/docs/README.md" + - "中文教程": + - "介绍": "2.0/tutorials/README.md" + - "中文文档": + - "介绍": "2.0/docs/README.md" - "PyTorch 1.7 中文文档": - "学习 PyTorch": - "PyTorch 深度学习：60 分钟的突击":