diff --git a/doc/sphinx/_static/css/default_overrides.css b/doc/sphinx/_static/css/default_overrides.css index e4edc07a84e5..a4645c39519b 100644 --- a/doc/sphinx/_static/css/default_overrides.css +++ b/doc/sphinx/_static/css/default_overrides.css @@ -16,4 +16,11 @@ .wy-nav-content-wrap { margin-left: 380px; +} + +@font-face{ + font-family:"Roboto Slab"; + font-style:normal; + font-weight:400; + src:url("../fonts/RobotoSlab/roboto-slab-v7-regular.eot?#iefix") format("embedded-opentype"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff2") format("woff2"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.woff") format("woff"),url("../fonts/RobotoSlab/roboto-slab-v7-regular.ttf") format("truetype") } \ No newline at end of file diff --git a/doc/sphinx/generate_doc.py b/doc/sphinx/generate_doc.py index 79d25505c2b5..380aabefb010 100644 --- a/doc/sphinx/generate_doc.py +++ b/doc/sphinx/generate_doc.py @@ -70,6 +70,7 @@ def make_title(title): # Update the code to compute this list automatically MULTIAPI_VERSION_NAMESPACE = [ "azure.mgmt.storage", + "azure.mgmt.web", "azure.mgmt.network", "azure.mgmt.compute", "azure.mgmt.containerregistry", diff --git a/doc/sphinx/generate_versioned_index.py b/doc/sphinx/generate_versioned_index.py index 085320a352a9..980170811d08 100644 --- a/doc/sphinx/generate_versioned_index.py +++ b/doc/sphinx/generate_versioned_index.py @@ -155,7 +155,7 @@ def write_toc_tree(categorized_menu_items): def get_categorized_menu_items(package_names): - categorized_menu_items = {} + categorized_menu_items = {"Other": {"Client":[], "Management":[], "Other": []}} for pkg in package_names: # add to the categorized menu items diff --git a/doc/sphinx/index.rst b/doc/sphinx/index.rst index 65369c8384e1..cdca4ef41e72 100644 --- a/doc/sphinx/index.rst +++ b/doc/sphinx/index.rst @@ -2,7 +2,7 @@ Azure SDK for Python ==================== -.. important:: The most part of this documentation has moved to https://docs.microsoft.com/python/azure +.. important:: You can find all of the Python on Azure documentation at https://docs.microsoft.com/python/azure The Azure SDK for Python is a set of libraries which allow you to work on Azure for your management, runtime or data needs. @@ -59,14 +59,6 @@ If you encounter any bugs with the library please file an issue in the `Issues `__ section of the project. - -Indices and tables ------------------- - -* :ref:`genindex` -* :ref:`modindex` -* :ref:`search` - .. toctree:: :glob: :caption: User Documentation diff --git a/doc/sphinx/package_service_mapping.json b/doc/sphinx/package_service_mapping.json index 83eeb4ceb06b..10afda75ad07 100644 --- a/doc/sphinx/package_service_mapping.json +++ b/doc/sphinx/package_service_mapping.json @@ -811,11 +811,16 @@ "azure-mgmt-web": { "category": "Management", "namespaces": [ - "azure.mgmt.web" + "azure.mgmt.web.v2015_04_01", + "azure.mgmt.web.v2015_08_01", + "azure.mgmt.web.v2016_03_01", + "azure.mgmt.web.v2016_08_01", + "azure.mgmt.web.v2016_09_01", + "azure.mgmt.web.v2018_02_01", + "azure.mgmt.web.v2018_11_01" ], "service_name": "Web Apps" }, - "azure-servicebus": { "category": "Client", "service_name": "Service Bus", @@ -991,7 +996,7 @@ }, "azure-mgmt-storagesync": { "category": "Management", - "service_name": "Storage", + "service_name": "Storage Sync", "namespaces": [ "azure.mgmt.storagesync" ] diff --git a/doc/sphinx/servicemanagement.rst b/doc/sphinx/servicemanagement.rst index 8823cdbbcf3b..5c8f35d3bec9 100644 --- a/doc/sphinx/servicemanagement.rst +++ b/doc/sphinx/servicemanagement.rst @@ -116,9 +116,9 @@ To make a new deployment to Azure you must store the package file in a Microsoft Azure Blob Storage account under the same subscription as the hosted service to which the package is being uploaded. You can create a deployment package with the `Microsoft Azure PowerShell -cmdlets `__, +cmdlets `__, or with the `cspack commandline -tool `__. +tool `__. .. code:: python diff --git a/eng/pipelines/create-doc-index.yml b/eng/pipelines/create-doc-index.yml index b915f0adcb40..4cec22966c87 100644 --- a/eng/pipelines/create-doc-index.yml +++ b/eng/pipelines/create-doc-index.yml @@ -27,10 +27,17 @@ jobs: inputs: versionSpec: $(PythonVersion) + - template: eng/pipelines/templates/scripts/replace-relative-links.yml@azure-sdk-tools + parameters: + TargetFolder: '.' + RootFolder: '.' + BuildSHA: $(Build.SourceVersion) + RepoId: 'Azure/azure-sdk-for-python' + - pwsh: | pip install -r $(Build.SourcesDirectory)/doc/sphinx/requirements.txt python $(Build.SourcesDirectory)/doc/sphinx/generate_versioned_index.py - mkdir $(Build.ArtifactStagingDirectory) + sphinx-build -b html -c $(Build.SourcesDirectory)/doc/sphinx $(Build.SourcesDirectory)/_docs $(Build.SourcesDirectory)/_docs/html Copy-Item -Path $(Build.SourcesDirectory)/_docs/html/* -Destination $(Build.ArtifactStagingDirectory) -Recurse -Force displayName: 'Generate Documentation Index'