mirror of
https://github.com/netbox-community/netbox.git
synced 2024-05-10 07:54:54 +00:00
Clean up documentation build warnings
This commit is contained in:
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
NetBox v2.9 introduced a new object-based permissions framework, which replace's Django's built-in permissions model. Object-based permissions enable an administrator to grant users or groups the ability to perform an action on arbitrary subsets of objects in NetBox, rather than all objects of a certain type. For example, it is possible to grant a user permission to view only sites within a particular region, or to modify only VLANs with a numeric ID within a certain range.
|
NetBox v2.9 introduced a new object-based permissions framework, which replace's Django's built-in permissions model. Object-based permissions enable an administrator to grant users or groups the ability to perform an action on arbitrary subsets of objects in NetBox, rather than all objects of a certain type. For example, it is possible to grant a user permission to view only sites within a particular region, or to modify only VLANs with a numeric ID within a certain range.
|
||||||
|
|
||||||
{!docs/models/users/objectpermission.md!}
|
{!models/users/objectpermission.md!}
|
||||||
|
|
||||||
### Example Constraint Definitions
|
### Example Constraint Definitions
|
||||||
|
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
# Circuits
|
# Circuits
|
||||||
|
|
||||||
{!docs/models/circuits/provider.md!}
|
{!models/circuits/provider.md!}
|
||||||
{!docs/models/circuits/providernetwork.md!}
|
{!models/circuits/providernetwork.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
{!docs/models/circuits/circuit.md!}
|
{!models/circuits/circuit.md!}
|
||||||
{!docs/models/circuits/circuittype.md!}
|
{!models/circuits/circuittype.md!}
|
||||||
{!docs/models/circuits/circuittermination.md!}
|
{!models/circuits/circuittermination.md!}
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
# Device Types
|
# Device Types
|
||||||
|
|
||||||
{!docs/models/dcim/devicetype.md!}
|
{!models/dcim/devicetype.md!}
|
||||||
{!docs/models/dcim/manufacturer.md!}
|
{!models/dcim/manufacturer.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -30,11 +30,11 @@ Once component templates have been created, every new device that you create as
|
|||||||
!!! note
|
!!! note
|
||||||
Assignment of components from templates occurs only at the time of device creation. If you modify the templates of a device type, it will not affect devices which have already been created. However, you always have the option of adding, modifying, or deleting components on existing devices.
|
Assignment of components from templates occurs only at the time of device creation. If you modify the templates of a device type, it will not affect devices which have already been created. However, you always have the option of adding, modifying, or deleting components on existing devices.
|
||||||
|
|
||||||
{!docs/models/dcim/consoleporttemplate.md!}
|
{!models/dcim/consoleporttemplate.md!}
|
||||||
{!docs/models/dcim/consoleserverporttemplate.md!}
|
{!models/dcim/consoleserverporttemplate.md!}
|
||||||
{!docs/models/dcim/powerporttemplate.md!}
|
{!models/dcim/powerporttemplate.md!}
|
||||||
{!docs/models/dcim/poweroutlettemplate.md!}
|
{!models/dcim/poweroutlettemplate.md!}
|
||||||
{!docs/models/dcim/interfacetemplate.md!}
|
{!models/dcim/interfacetemplate.md!}
|
||||||
{!docs/models/dcim/frontporttemplate.md!}
|
{!models/dcim/frontporttemplate.md!}
|
||||||
{!docs/models/dcim/rearporttemplate.md!}
|
{!models/dcim/rearporttemplate.md!}
|
||||||
{!docs/models/dcim/devicebaytemplate.md!}
|
{!models/dcim/devicebaytemplate.md!}
|
||||||
|
@ -1,8 +1,8 @@
|
|||||||
# Devices and Cabling
|
# Devices and Cabling
|
||||||
|
|
||||||
{!docs/models/dcim/device.md!}
|
{!models/dcim/device.md!}
|
||||||
{!docs/models/dcim/devicerole.md!}
|
{!models/dcim/devicerole.md!}
|
||||||
{!docs/models/dcim/platform.md!}
|
{!models/dcim/platform.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -10,20 +10,20 @@
|
|||||||
|
|
||||||
Device components represent discrete objects within a device which are used to terminate cables, house child devices, or track resources.
|
Device components represent discrete objects within a device which are used to terminate cables, house child devices, or track resources.
|
||||||
|
|
||||||
{!docs/models/dcim/consoleport.md!}
|
{!models/dcim/consoleport.md!}
|
||||||
{!docs/models/dcim/consoleserverport.md!}
|
{!models/dcim/consoleserverport.md!}
|
||||||
{!docs/models/dcim/powerport.md!}
|
{!models/dcim/powerport.md!}
|
||||||
{!docs/models/dcim/poweroutlet.md!}
|
{!models/dcim/poweroutlet.md!}
|
||||||
{!docs/models/dcim/interface.md!}
|
{!models/dcim/interface.md!}
|
||||||
{!docs/models/dcim/frontport.md!}
|
{!models/dcim/frontport.md!}
|
||||||
{!docs/models/dcim/rearport.md!}
|
{!models/dcim/rearport.md!}
|
||||||
{!docs/models/dcim/devicebay.md!}
|
{!models/dcim/devicebay.md!}
|
||||||
{!docs/models/dcim/inventoryitem.md!}
|
{!models/dcim/inventoryitem.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
{!docs/models/dcim/virtualchassis.md!}
|
{!models/dcim/virtualchassis.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
{!docs/models/dcim/cable.md!}
|
{!models/dcim/cable.md!}
|
||||||
|
@ -1,19 +1,19 @@
|
|||||||
# IP Address Management
|
# IP Address Management
|
||||||
|
|
||||||
{!docs/models/ipam/aggregate.md!}
|
{!models/ipam/aggregate.md!}
|
||||||
{!docs/models/ipam/rir.md!}
|
{!models/ipam/rir.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
{!docs/models/ipam/prefix.md!}
|
{!models/ipam/prefix.md!}
|
||||||
{!docs/models/ipam/role.md!}
|
{!models/ipam/role.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
{!docs/models/ipam/iprange.md!}
|
{!models/ipam/iprange.md!}
|
||||||
{!docs/models/ipam/ipaddress.md!}
|
{!models/ipam/ipaddress.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
{!docs/models/ipam/vrf.md!}
|
{!models/ipam/vrf.md!}
|
||||||
{!docs/models/ipam/routetarget.md!}
|
{!models/ipam/routetarget.md!}
|
||||||
|
@ -1,8 +1,8 @@
|
|||||||
# Power Tracking
|
# Power Tracking
|
||||||
|
|
||||||
{!docs/models/dcim/powerpanel.md!}
|
{!models/dcim/powerpanel.md!}
|
||||||
{!docs/models/dcim/powerfeed.md!}
|
{!models/dcim/powerfeed.md!}
|
||||||
|
|
||||||
# Example Power Topology
|
# Example Power Topology
|
||||||
|
|
||||||

|

|
||||||
|
@ -1,3 +1,3 @@
|
|||||||
# Service Mapping
|
# Service Mapping
|
||||||
|
|
||||||
{!docs/models/ipam/service.md!}
|
{!models/ipam/service.md!}
|
||||||
|
@ -1,12 +1,12 @@
|
|||||||
# Sites and Racks
|
# Sites and Racks
|
||||||
|
|
||||||
{!docs/models/dcim/region.md!}
|
{!models/dcim/region.md!}
|
||||||
{!docs/models/dcim/sitegroup.md!}
|
{!models/dcim/sitegroup.md!}
|
||||||
{!docs/models/dcim/site.md!}
|
{!models/dcim/site.md!}
|
||||||
{!docs/models/dcim/location.md!}
|
{!models/dcim/location.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
{!docs/models/dcim/rack.md!}
|
{!models/dcim/rack.md!}
|
||||||
{!docs/models/dcim/rackrole.md!}
|
{!models/dcim/rackrole.md!}
|
||||||
{!docs/models/dcim/rackreservation.md!}
|
{!models/dcim/rackreservation.md!}
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
# Tenancy Assignment
|
# Tenancy Assignment
|
||||||
|
|
||||||
{!docs/models/tenancy/tenant.md!}
|
{!models/tenancy/tenant.md!}
|
||||||
{!docs/models/tenancy/tenantgroup.md!}
|
{!models/tenancy/tenantgroup.md!}
|
||||||
|
@ -1,10 +1,10 @@
|
|||||||
# Virtualization
|
# Virtualization
|
||||||
|
|
||||||
{!docs/models/virtualization/cluster.md!}
|
{!models/virtualization/cluster.md!}
|
||||||
{!docs/models/virtualization/clustertype.md!}
|
{!models/virtualization/clustertype.md!}
|
||||||
{!docs/models/virtualization/clustergroup.md!}
|
{!models/virtualization/clustergroup.md!}
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
{!docs/models/virtualization/virtualmachine.md!}
|
{!models/virtualization/virtualmachine.md!}
|
||||||
{!docs/models/virtualization/vminterface.md!}
|
{!models/virtualization/vminterface.md!}
|
||||||
|
@ -1,4 +1,4 @@
|
|||||||
# VLAN Management
|
# VLAN Management
|
||||||
|
|
||||||
{!docs/models/ipam/vlan.md!}
|
{!models/ipam/vlan.md!}
|
||||||
{!docs/models/ipam/vlangroup.md!}
|
{!models/ipam/vlangroup.md!}
|
||||||
|
@ -226,7 +226,7 @@ An IPv4 or IPv6 network with a mask. Returns a `netaddr.IPNetwork` object. Two a
|
|||||||
!!! note
|
!!! note
|
||||||
To run a custom script, a user must be assigned the `extras.run_script` permission. This is achieved by assigning the user (or group) a permission on the Script object and specifying the `run` action in the admin UI as shown below.
|
To run a custom script, a user must be assigned the `extras.run_script` permission. This is achieved by assigning the user (or group) a permission on the Script object and specifying the `run` action in the admin UI as shown below.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
### Via the Web UI
|
### Via the Web UI
|
||||||
|
|
||||||
|
@ -104,7 +104,7 @@ Once you have created a report, it will appear in the reports list. Initially, r
|
|||||||
!!! note
|
!!! note
|
||||||
To run a report, a user must be assigned the `extras.run_report` permission. This is achieved by assigning the user (or group) a permission on the Report object and specifying the `run` action in the admin UI as shown below.
|
To run a report, a user must be assigned the `extras.run_report` permission. This is achieved by assigning the user (or group) a permission on the Report object and specifying the `run` action in the admin UI as shown below.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
### Via the Web UI
|
### Via the Web UI
|
||||||
|
|
||||||
|
@ -25,7 +25,7 @@ A cable may be traced from either of its endpoints by clicking the "trace" butto
|
|||||||
|
|
||||||
In the example below, three individual cables comprise a path between devices A and D:
|
In the example below, three individual cables comprise a path between devices A and D:
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
Traced from Interface 1 on Device A, NetBox will show the following path:
|
Traced from Interface 1 on Device A, NetBox will show the following path:
|
||||||
|
|
||||||
|
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
The NetBox REST API primarily employs token-based authentication. For convenience, cookie-based authentication can also be used when navigating the browsable API.
|
The NetBox REST API primarily employs token-based authentication. For convenience, cookie-based authentication can also be used when navigating the browsable API.
|
||||||
|
|
||||||
{!docs/models/users/token.md!}
|
{!models/users/token.md!}
|
||||||
|
|
||||||
## Authenticating to the API
|
## Authenticating to the API
|
||||||
|
|
||||||
|
@ -3,9 +3,6 @@ site_dir: netbox/project-static/docs
|
|||||||
site_url: https://netbox.readthedocs.io/
|
site_url: https://netbox.readthedocs.io/
|
||||||
repo_name: netbox-community/netbox
|
repo_name: netbox-community/netbox
|
||||||
repo_url: https://github.com/netbox-community/netbox
|
repo_url: https://github.com/netbox-community/netbox
|
||||||
python:
|
|
||||||
install:
|
|
||||||
- requirements: docs/requirements.txt
|
|
||||||
theme:
|
theme:
|
||||||
name: material
|
name: material
|
||||||
icon:
|
icon:
|
||||||
@ -24,13 +21,14 @@ extra:
|
|||||||
- icon: fontawesome/brands/github
|
- icon: fontawesome/brands/github
|
||||||
link: https://github.com/netbox-community/netbox
|
link: https://github.com/netbox-community/netbox
|
||||||
- icon: fontawesome/brands/slack
|
- icon: fontawesome/brands/slack
|
||||||
link: https://slack.netbox.dev
|
link: https://netdev.chat/
|
||||||
extra_css:
|
extra_css:
|
||||||
- extra.css
|
- extra.css
|
||||||
markdown_extensions:
|
markdown_extensions:
|
||||||
- admonition
|
- admonition
|
||||||
- attr_list
|
- attr_list
|
||||||
- markdown_include.include:
|
- markdown_include.include:
|
||||||
|
base_path: 'docs/'
|
||||||
headingOffset: 1
|
headingOffset: 1
|
||||||
- pymdownx.emoji:
|
- pymdownx.emoji:
|
||||||
emoji_index: !!python/name:materialx.emoji.twemoji
|
emoji_index: !!python/name:materialx.emoji.twemoji
|
||||||
|
Reference in New Issue
Block a user