From 64fc6d78904def8c55d0608c88f2d4495c715bc1 Mon Sep 17 00:00:00 2001 From: Thomas Dinges Date: Thu, 18 Jan 2024 16:10:52 +0100 Subject: [PATCH] Docs: Replace most wiki links with links to new developer docs Exceptions: * Links to personal wiki pages * Pages that are not in the new developer docs yet (like Human Interface Guidelines) * tools\check_wiki\check_wiki_file_structure.py needs a refactor --- .gitea/issue_template/bug.yaml | 6 +++--- .gitea/pull_request_template.yaml | 2 +- .github/pull_request_template.md | 2 +- .github/stale.yml | 2 +- CMakeLists.txt | 2 +- GNUmakefile | 2 +- README.md | 4 ++-- build_files/build_environment/install_linux_packages.py | 2 +- build_files/build_environment/linux/linux_rocky8_setup.sh | 2 +- build_files/cmake/example_scripts/cmake_linux_install.sh | 2 +- doc/doxygen/doxygen.main.h | 2 +- doc/python_api/examples/bpy.app.translations.py | 6 +++--- doc/python_api/rst/include__bmesh.rst | 2 +- doc/python_api/rst/info_advanced_blender_as_bpy.rst | 2 +- doc/python_api/rst/info_overview.rst | 2 +- doc/python_api/rst/info_tips_and_tricks.rst | 2 +- release/freedesktop/org.blender.Blender.metainfo.xml | 2 +- release/text/readme.html | 6 +++--- scripts/startup/bl_ui/space_topbar.py | 2 +- source/blender/asset_system/AS_asset_catalog_path.hh | 2 +- source/blender/asset_system/AS_asset_identifier.hh | 2 +- source/blender/asset_system/AS_asset_representation.hh | 2 +- source/blender/asset_system/intern/asset_library_service.cc | 2 +- source/blender/blenkernel/BKE_blender_version.h | 2 +- source/blender/blenkernel/intern/armature.cc | 2 +- source/blender/editors/include/UI_abstract_view.hh | 2 +- source/blender/editors/include/UI_grid_view.hh | 2 +- source/blender/editors/include/UI_tree_view.hh | 2 +- source/blender/python/generic/py_capi_utils.cc | 2 +- source/blender/python/gpu/gpu_py_shader_create_info.cc | 6 +++--- source/creator/creator.cc | 2 +- 31 files changed, 40 insertions(+), 40 deletions(-) diff --git a/.gitea/issue_template/bug.yaml b/.gitea/issue_template/bug.yaml index e4564a1bb33..01a94dc965e 100644 --- a/.gitea/issue_template/bug.yaml +++ b/.gitea/issue_template/bug.yaml @@ -9,13 +9,13 @@ body: attributes: value: | ### Instructions - First time reporting? See [tips](https://wiki.blender.org/wiki/Process/Bug_Reports). + First time reporting? See [tips](https://developer.blender.org/docs/handbook/bug_reports/making_good_bug_reports/). * Use **Help > Report a Bug** in Blender to fill system information and exact Blender version. * Test [daily builds](https://builder.blender.org/) to verify if the issue is already fixed. * Test [previous versions](https://download.blender.org/release/) to find an older working version. - * For feature requests, feedback, questions or build issues, see [communication channels](https://wiki.blender.org/wiki/Communication/Contact#User_Feedback_and_Requests). - * Security vulnerabilities should be [reported privately](https://wiki.blender.org/wiki/Process/Vulnerability_Reports). + * For feature requests, feedback, questions or build issues, see [communication channels](https://developer.blender.org/docs/handbook/communication/user_feedback/). + * Security vulnerabilities should be [reported privately](https://developer.blender.org/docs/handbook/bug_reports/vulnerability_reports/). * If there are multiple bugs, make multiple bug reports. - type: textarea diff --git a/.gitea/pull_request_template.yaml b/.gitea/pull_request_template.yaml index ffca6172592..d4e68f1890a 100644 --- a/.gitea/pull_request_template.yaml +++ b/.gitea/pull_request_template.yaml @@ -6,7 +6,7 @@ body: value: | ### Instructions - Guides to [contributing code](https://wiki.blender.org/index.php/Dev:Doc/Process/Contributing_Code) and effective [code review](https://wiki.blender.org/index.php/Dev:Doc/Tools/Code_Review). + Guides to [contributing code](https://developer.blender.org/docs/handbook/contributing/) and effective [code review](https://developer.blender.org/docs/handbook/contributing/pull_requests/). By submitting code here, you agree that the code is (compatible with) GNU GPL v2 or later. diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 4b8e99e669a..e37b8ff35c6 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,4 +1,4 @@ This repository is only used as a mirror. Blender development happens on projects.blender.org. To get started with contributing code, please see: -https://wiki.blender.org/wiki/Process/Contributing_Code +https://developer.blender.org/docs/handbook/contributing/ diff --git a/.github/stale.yml b/.github/stale.yml index db14bfd9d31..2b7adb5176e 100644 --- a/.github/stale.yml +++ b/.github/stale.yml @@ -18,4 +18,4 @@ closeComment: > used as a mirror. Blender development happens on projects.blender.org. To get started contributing code, please read: - https://wiki.blender.org/wiki/Process/Contributing_Code + https://developer.blender.org/docs/handbook/contributing/ diff --git a/CMakeLists.txt b/CMakeLists.txt index 74488132bf7..80711159b17 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -110,7 +110,7 @@ enable_testing() # ----------------------------------------------------------------------------- # Test Compiler Support # -# Keep in sync with: https://wiki.blender.org/wiki/Building_Blender +# Keep in sync with: https://developer.blender.org/docs/handbook/building_blender/ if(CMAKE_COMPILER_IS_GNUCC) if("${CMAKE_C_COMPILER_VERSION}" VERSION_LESS "11.0.0") diff --git a/GNUmakefile b/GNUmakefile index d18b5f01a30..97fbf1e05f5 100644 --- a/GNUmakefile +++ b/GNUmakefile @@ -76,7 +76,7 @@ Documentation Checking * check_wiki_file_structure: Check the WIKI documentation for the source-tree's file structure matches Blender's source-code. - See: https://wiki.blender.org/wiki/Source/File_Structure + See: https://developer.blender.org/docs/features/code_layout/ Spell Checkers This runs the spell checker from the developer tools repositor. diff --git a/README.md b/README.md index 76243cbeff3..c92ddb65bab 100644 --- a/README.md +++ b/README.md @@ -23,10 +23,10 @@ Project Pages Development ----------- -- [Build Instructions](https://wiki.blender.org/wiki/Building_Blender) +- [Build Instructions](https://developer.blender.org/docs/handbook/building_blender/) - [Code Review & Bug Tracker](https://projects.blender.org) - [Developer Forum](https://devtalk.blender.org) -- [Developer Documentation](https://wiki.blender.org) +- [Developer Documentation](https://developer.blender.org/docs/) License diff --git a/build_files/build_environment/install_linux_packages.py b/build_files/build_environment/install_linux_packages.py index d6d492a679d..d0d6ffda8f2 100755 --- a/build_files/build_environment/install_linux_packages.py +++ b/build_files/build_environment/install_linux_packages.py @@ -1714,7 +1714,7 @@ def argparse_create(): "NOTE: To build with system package libraries instead of the precompiled ones when both are available,\n" "the `WITH_LIBS_PRECOMPILED` option must be disabled in CMake.\n" "\n" - "See https://wiki.blender.org/wiki/Building_Blender for more details.\n" + "See https://developer.blender.org/docs/handbook/building_blender/ for more details.\n" "\n" ) diff --git a/build_files/build_environment/linux/linux_rocky8_setup.sh b/build_files/build_environment/linux/linux_rocky8_setup.sh index 1870a9aeef1..c5573a1d623 100644 --- a/build_files/build_environment/linux/linux_rocky8_setup.sh +++ b/build_files/build_environment/linux/linux_rocky8_setup.sh @@ -4,7 +4,7 @@ # SPDX-License-Identifier: GPL-2.0-or-later # This script is part of the official build environment, see wiki page for details. -# https://wiki.blender.org/wiki/Building_Blender/Other/Rocky8ReleaseEnvironment +# https://developer.blender.org/docs/handbook/release_process/build/rocky_8/ set -e diff --git a/build_files/cmake/example_scripts/cmake_linux_install.sh b/build_files/cmake/example_scripts/cmake_linux_install.sh index 3339ba96327..73772051d94 100755 --- a/build_files/cmake/example_scripts/cmake_linux_install.sh +++ b/build_files/cmake/example_scripts/cmake_linux_install.sh @@ -7,7 +7,7 @@ # assumes you have dependencies installed already # See this page for more info: -# https://wiki.blender.org/wiki/Building_Blender/Linux/Generic_Distro/CMake +# https://developer.blender.org/docs/handbook/building_blender/linux/ # grab blender mkdir ~/blender-git diff --git a/doc/doxygen/doxygen.main.h b/doc/doxygen/doxygen.main.h index 70120cfbfd5..2b129e8db6e 100644 --- a/doc/doxygen/doxygen.main.h +++ b/doc/doxygen/doxygen.main.h @@ -12,7 +12,7 @@ * * \subsection implinks Important Links * - developer.blender.org with bug tracker. - * - Development documents on our wiki. + * - Development documentation. * * \subsection blother Other * For more information on using Blender browse to https://www.blender.org diff --git a/doc/python_api/examples/bpy.app.translations.py b/doc/python_api/examples/bpy.app.translations.py index ed975f68a4c..36ce34264b5 100644 --- a/doc/python_api/examples/bpy.app.translations.py +++ b/doc/python_api/examples/bpy.app.translations.py @@ -23,8 +23,8 @@ Then, call ``bpy.app.translations.register(__name__, your_dict)`` in your ``regi The ``Manage UI translations`` add-on has several functions to help you collect strings to translate, and generate the needed python code (the translation dictionary), as well as optional intermediary po files if you want some... See -`How to Translate Blender `_ and -`Using i18n in Blender Code `_ +`How to Translate Blender `_ and +`Using i18n in Blender Code `_ for more info. Module References @@ -35,7 +35,7 @@ Module References import bpy # This block can be automatically generated by UI translations addon, which also handles conversion with PO format. -# See also https://wiki.blender.org/wiki/Process/Translate_Blender#Translating_non-official_addons +# See also https://developer.blender.org/docs/handbook/translating/translator_guide/#translating-non-official-add-ons # It can (should) also be put in a different, specific py file. # ##### BEGIN AUTOGENERATED I18N SECTION ##### diff --git a/doc/python_api/rst/include__bmesh.rst b/doc/python_api/rst/include__bmesh.rst index f2197dadea4..e8cd23e41da 100644 --- a/doc/python_api/rst/include__bmesh.rst +++ b/doc/python_api/rst/include__bmesh.rst @@ -14,7 +14,7 @@ The features exposed closely follow the C API, giving Python access to the functions used by Blender's own mesh editing tools. For an overview of BMesh data types and how they reference each other see: -`BMesh Design Document `__. +`BMesh Design Document `__. .. note:: diff --git a/doc/python_api/rst/info_advanced_blender_as_bpy.rst b/doc/python_api/rst/info_advanced_blender_as_bpy.rst index fadf4a7467b..dc23dd10428 100644 --- a/doc/python_api/rst/info_advanced_blender_as_bpy.rst +++ b/doc/python_api/rst/info_advanced_blender_as_bpy.rst @@ -13,7 +13,7 @@ allowing ``import bpy`` to be added to any Python script, providing access to Bl - A pre-compiled ``bpy`` module is `available via PIP `__. - Or you may compile this yourself using the - `build instructions `__. + `build instructions `__. Use Cases diff --git a/doc/python_api/rst/info_overview.rst b/doc/python_api/rst/info_overview.rst index 638420a53ae..016f4acb11e 100644 --- a/doc/python_api/rst/info_overview.rst +++ b/doc/python_api/rst/info_overview.rst @@ -91,7 +91,7 @@ They are only loaded on startup if selected from the user preferences. The only difference between add-ons and built-in Python modules is that add-ons must contain a ``bl_info`` variable which Blender uses to read metadata such as name, author, category and project link. The User Preferences add-on listing uses ``bl_info`` to display information about each add-on. -`See Add-ons `__ +`See Add-ons `__ for details on the ``bl_info`` dictionary. diff --git a/doc/python_api/rst/info_tips_and_tricks.rst b/doc/python_api/rst/info_tips_and_tricks.rst index 691cfb50b4f..18d4d823f44 100644 --- a/doc/python_api/rst/info_tips_and_tricks.rst +++ b/doc/python_api/rst/info_tips_and_tricks.rst @@ -295,7 +295,7 @@ Advantages include: This is marked advanced because to run Blender as a Python module requires a special build option. For instructions on building see -`Building Blender as a Python module `__. +`Building Blender as a Python module `__. Python Safety (Build Option) diff --git a/release/freedesktop/org.blender.Blender.metainfo.xml b/release/freedesktop/org.blender.Blender.metainfo.xml index 0ca31654885..6dc8a17fcbe 100644 --- a/release/freedesktop/org.blender.Blender.metainfo.xml +++ b/release/freedesktop/org.blender.Blender.metainfo.xml @@ -26,7 +26,7 @@ https://www.blender.org/support/faq/ https://www.blender.org/support/ https://fund.blender.org/ - https://wiki.blender.org/wiki/Process/Translate_Blender + https://developer.blender.org/docs/handbook/translating/translator_guide/ https://projects.blender.org/blender/blender https://www.blender.org/get-involved/ diff --git a/release/text/readme.html b/release/text/readme.html index 6dfd5e09e64..1338a14480b 100644 --- a/release/text/readme.html +++ b/release/text/readme.html @@ -43,7 +43,7 @@

The Blender Foundation and online developer community is proud to present Blender @BLENDER_VERSION@. - + More information about this release .

@@ -95,8 +95,8 @@ www.blender.org
Release Notes - - wiki.blender.org/wiki/Reference/Release_Notes/@BLENDER_VERSION@ + + https://developer.blender.org/docs/release_notes/@BLENDER_VERSION@
Tutorials diff --git a/scripts/startup/bl_ui/space_topbar.py b/scripts/startup/bl_ui/space_topbar.py index ab1663c2ada..77a9e8a7735 100644 --- a/scripts/startup/bl_ui/space_topbar.py +++ b/scripts/startup/bl_ui/space_topbar.py @@ -708,7 +708,7 @@ class TOPBAR_MT_help(Menu): "wm.url_open", text="Developer Documentation", icon='URL', - ).url = "https://wiki.blender.org/wiki/Main_Page" + ).url = "https://developer.blender.org/docs/" layout.operator("wm.url_open", text="Developer Community").url = "https://devtalk.blender.org" layout.operator("wm.url_open_preset", text="Python API Reference").type = 'API' layout.operator("wm.operator_cheat_sheet", icon='TEXT') diff --git a/source/blender/asset_system/AS_asset_catalog_path.hh b/source/blender/asset_system/AS_asset_catalog_path.hh index 33750cda0be..31df4815438 100644 --- a/source/blender/asset_system/AS_asset_catalog_path.hh +++ b/source/blender/asset_system/AS_asset_catalog_path.hh @@ -29,7 +29,7 @@ namespace blender::asset_system { * - Only slashes are used as path component separators. * - All paths are absolute, so there is no need for a leading slash. * - * See https://wiki.blender.org/wiki/Source/Architecture/Asset_System/Catalogs + * See https://developer.blender.org/docs/features/asset_system/backend/asset_catalogs/ * * Paths are stored as byte sequences, and assumed to be UTF-8. */ diff --git a/source/blender/asset_system/AS_asset_identifier.hh b/source/blender/asset_system/AS_asset_identifier.hh index 6a2315927d0..3fb39642442 100644 --- a/source/blender/asset_system/AS_asset_identifier.hh +++ b/source/blender/asset_system/AS_asset_identifier.hh @@ -7,7 +7,7 @@ * * \brief Information to uniquely identify and locate an asset. * - * https://wiki.blender.org/wiki/Source/Architecture/Asset_System/Back_End#Asset_Identifier + * https://developer.blender.org/docs/features/asset_system/backend/#asset-identifier */ #pragma once diff --git a/source/blender/asset_system/AS_asset_representation.hh b/source/blender/asset_system/AS_asset_representation.hh index 627013d05e5..4ec03e31225 100644 --- a/source/blender/asset_system/AS_asset_representation.hh +++ b/source/blender/asset_system/AS_asset_representation.hh @@ -8,7 +8,7 @@ * \brief Main runtime representation of an asset. * * Abstraction to reference an asset, with necessary data for display & interaction. - * https://wiki.blender.org/wiki/Source/Architecture/Asset_System/Back_End#Asset_Representation + * https://developer.blender.org/docs/features/asset_system/backend/#asset-representation */ #pragma once diff --git a/source/blender/asset_system/intern/asset_library_service.cc b/source/blender/asset_system/intern/asset_library_service.cc index cdf17a843da..fdeaf294cfe 100644 --- a/source/blender/asset_system/intern/asset_library_service.cc +++ b/source/blender/asset_system/intern/asset_library_service.cc @@ -30,7 +30,7 @@ * TODO Currently disabled because UI data depends on asset library data, so we have to make sure * it's freed in the right order (UI first). Pre-load handlers don't give us this order. * Should be addressed with a proper ownership model for the asset system: - * https://wiki.blender.org/wiki/Source/Architecture/Asset_System/Back_End#Ownership_Model + * https://developer.blender.org/docs/features/asset_system/backend/#ownership-model */ // #define WITH_DESTROY_VIA_LOAD_HANDLER diff --git a/source/blender/blenkernel/BKE_blender_version.h b/source/blender/blenkernel/BKE_blender_version.h index 970378b0d23..4d37b9f9599 100644 --- a/source/blender/blenkernel/BKE_blender_version.h +++ b/source/blender/blenkernel/BKE_blender_version.h @@ -35,7 +35,7 @@ extern "C" { * version. Older Blender versions will test this and cancel loading the file, showing a warning to * the user. * - * See https://wiki.blender.org/wiki/Process/Compatibility_Handling for details. */ + * See https://developer.blender.org/docs/handbook/guidelines/compatibility_handling_for_blend_files/ for details. */ #define BLENDER_FILE_MIN_VERSION 306 #define BLENDER_FILE_MIN_SUBVERSION 13 diff --git a/source/blender/blenkernel/intern/armature.cc b/source/blender/blenkernel/intern/armature.cc index d5d2f93ef8c..0ef77960d72 100644 --- a/source/blender/blenkernel/intern/armature.cc +++ b/source/blender/blenkernel/intern/armature.cc @@ -1898,7 +1898,7 @@ static void find_bbone_segment_index_curved(const bPoseChannel *pchan, * reduce the gradient slope to the ideal value (the one you get for points directly on * the curve), using heuristic blend strength falloff coefficients based on the distances * to the boundary plane before and after mapping. See PR #110758 for more details, or - * https://wiki.blender.org/wiki/Source/Animation/B-Bone_Vertex_Mapping#Curved_Mapping */ + * https://developer.blender.org/docs/features/animation/b-bone_vertex_mapping/#curved-mapping */ const float segment_scale = pchan->runtime.bbone_arc_length_reciprocal; for (int i = stack_top; i >= 0; --i) { diff --git a/source/blender/editors/include/UI_abstract_view.hh b/source/blender/editors/include/UI_abstract_view.hh index b981969783c..aa708723531 100644 --- a/source/blender/editors/include/UI_abstract_view.hh +++ b/source/blender/editors/include/UI_abstract_view.hh @@ -6,7 +6,7 @@ * \ingroup editorui * * Base class for all views (UIs to display data sets) and view items, supporting common features. - * https://wiki.blender.org/wiki/Source/Interface/Views + * https://developer.blender.org/docs/features/interface/views/ * * One of the most important responsibilities of the base class is managing reconstruction, * enabling state that is persistent over reconstructions/redraws. Other features: diff --git a/source/blender/editors/include/UI_grid_view.hh b/source/blender/editors/include/UI_grid_view.hh index 167d76ad2d9..69214c1955d 100644 --- a/source/blender/editors/include/UI_grid_view.hh +++ b/source/blender/editors/include/UI_grid_view.hh @@ -6,7 +6,7 @@ * \ingroup editorui * * API for simple creation of grid UIs, supporting typically needed features. - * https://wiki.blender.org/wiki/Source/Interface/Views/Grid_Views + * https://developer.blender.org/docs/features/interface/views/grid_views/ */ #pragma once diff --git a/source/blender/editors/include/UI_tree_view.hh b/source/blender/editors/include/UI_tree_view.hh index d409f1376c5..440b3d1a8ac 100644 --- a/source/blender/editors/include/UI_tree_view.hh +++ b/source/blender/editors/include/UI_tree_view.hh @@ -6,7 +6,7 @@ * \ingroup editorui * * API for simple creation of tree UIs supporting typically needed features. - * https://wiki.blender.org/wiki/Source/Interface/Views/Tree_Views + * https://developer.blender.org/docs/features/interface/views/tree_views/ */ #pragma once diff --git a/source/blender/python/generic/py_capi_utils.cc b/source/blender/python/generic/py_capi_utils.cc index 7be33b99196..8d9e62e2e65 100644 --- a/source/blender/python/generic/py_capi_utils.cc +++ b/source/blender/python/generic/py_capi_utils.cc @@ -1166,7 +1166,7 @@ bool PyC_IsInterpreterActive() void PyC_RunQuicky(const char *filepath, int n, ...) { /* NOTE: Would be nice if python had this built in - * See: https://wiki.blender.org/wiki/Tools/Debugging/PyFromC */ + * See: https://developer.blender.org/docs/handbook/tooling/pyfromc/ */ FILE *fp = fopen(filepath, "r"); diff --git a/source/blender/python/gpu/gpu_py_shader_create_info.cc b/source/blender/python/gpu/gpu_py_shader_create_info.cc index 689542632ba..2679f3d8796 100644 --- a/source/blender/python/gpu/gpu_py_shader_create_info.cc +++ b/source/blender/python/gpu/gpu_py_shader_create_info.cc @@ -932,7 +932,7 @@ PyDoc_STRVAR( " :type source: str\n" "\n" " .. seealso:: `GLSL Cross Compilation " - "`__\n"); + "`__\n"); static PyObject *pygpu_shader_info_vertex_source(BPyGPUShaderCreateInfo *self, PyObject *o) { const char *vertex_source = PyUnicode_AsUTF8(o); @@ -977,7 +977,7 @@ PyDoc_STRVAR( " :type source: str\n" "\n" " .. seealso:: `GLSL Cross Compilation " - "`__\n"); + "`__\n"); static PyObject *pygpu_shader_info_compute_source(BPyGPUShaderCreateInfo *self, PyObject *o) { const char *compute_source = PyUnicode_AsUTF8(o); @@ -1018,7 +1018,7 @@ PyDoc_STRVAR( " :type source: str\n" "\n" " .. seealso:: `GLSL Cross Compilation " - "`__\n"); + "`__\n"); static PyObject *pygpu_shader_info_fragment_source(BPyGPUShaderCreateInfo *self, PyObject *o) { const char *fragment_source = PyUnicode_AsUTF8(o); diff --git a/source/creator/creator.cc b/source/creator/creator.cc index 6fbb26cb523..bbcde3dc198 100644 --- a/source/creator/creator.cc +++ b/source/creator/creator.cc @@ -195,7 +195,7 @@ static void callback_clg_fatal(void *fp) /** \name Blender as a Stand-Alone Python Module (bpy) * * While not officially supported, this can be useful for Python developers. - * See: https://wiki.blender.org/wiki/Building_Blender/Other/BlenderAsPyModule + * See: https://developer.blender.org/docs/handbook/building_blender/python_module/ * \{ */ #ifdef WITH_PYTHON_MODULE