Docs: Fix Addons Spelling and Links #54

Merged
Nick Alberelli merged 7 commits from docs/cleanup-addon-readmes into main 2023-05-19 19:14:23 +02:00
Showing only changes of commit fbeae0a978 - Show all commits

View File

@ -40,7 +40,7 @@ After installing you need to setup the addon preferences to fit your environment
In order to be able to log in to Kitsu you need a server that runs the Kitsu production management suite. In order to be able to log in to Kitsu you need a server that runs the Kitsu production management suite.
Information on how to set up Kitsu can be found [here](https://zou.cg-wire.com/). Information on how to set up Kitsu can be found [here](https://zou.cg-wire.com/).
If Kitsu is up and running and you can succesfully log in via the web interface you have to setup the `addon preferences`. If Kitsu is up and running and you can successfully log in via the web interface you have to setup the `addon preferences`.
> **_NOTE:_** If you want to get started quickly you only need to setup login data and active project > **_NOTE:_** If you want to get started quickly you only need to setup login data and active project
@ -48,17 +48,17 @@ If Kitsu is up and running and you can succesfully log in via the web interface
![image info](/media/addons/blender_kitsu/prefs_login.jpg) ![image info](/media/addons/blender_kitsu/prefs_login.jpg)
>**Host**: The webadress of your kitsu server (e.G https://kitsu.mydomain.com)<br/> >**Host**: The web address of your kitsu server (e.G https://kitsu.mydomain.com)<br/>
**Email**: The email you use to log in to kitsu<br/> **Email**: The email you use to log in to kitsu<br/>
**Password**: The password you use to log in to kitsu<br/> **Password**: The password you use to log in to kitsu<br/>
Press the login button. If the login was succesfull, the next step is.. Press the login button. If the login was successful, the next step is..
###### **Setup Project Settings** ###### **Setup Project Settings**
![image info](/media/addons/blender_kitsu/prefs_project.jpg) ![image info](/media/addons/blender_kitsu/prefs_project.jpg)
>**Project Root Directory**: Path to the root of your project. Will later be used to configurate the addon on a per project basis<br/> >**Project Root Directory**: Path to the root of your project. Will later be used to configure the addon on a per project basis<br/>
###### **Setup Animation Tools** ###### **Setup Animation Tools**
@ -82,7 +82,7 @@ Press the login button. If the login was succesfull, the next step is..
![image info](/media/addons/blender_kitsu/prefs_outdated_media.jpg) ![image info](/media/addons/blender_kitsu/prefs_outdated_media.jpg)
>**Path List**: List of paths to top level directorys. Only media that is a child (recursive) of one of these directories will be scanned for outdated media.<br/> >**Path List**: List of paths to top level directory. Only media that is a child (recursive) of one of these directories will be scanned for outdated media.<br/>
###### **Setup Miscellaneous** ###### **Setup Miscellaneous**
@ -103,7 +103,7 @@ blender-kitsu has many feature and in this documentation they are divided in dif
blender-kitsu sequence editor tools were constructed with the idea in mind to have a relationship between sequence strips and shots on Kitsu. This connection enables the exchange of metadata between the edit and the shots on Kitsu. Some examples are frame ranges of shots can be directly updated from the edit or thumbnails can be rendered and uploaded to Kitsu with a click of a button and many more which you will find out in this section: blender-kitsu sequence editor tools were constructed with the idea in mind to have a relationship between sequence strips and shots on Kitsu. This connection enables the exchange of metadata between the edit and the shots on Kitsu. Some examples are frame ranges of shots can be directly updated from the edit or thumbnails can be rendered and uploaded to Kitsu with a click of a button and many more which you will find out in this section:
##### Metastrips ##### Metastrips
Metastrips are regular Movie Strips that can be linked to a shot in kitsu. It is a good idea to create a seperate meta strip in a seperate channel that represents the shot. That gives you the freedom to assemble a shot out of multiple elements, like multiple storyboard pictures, and still have one metastrip that contains the full shot range. Metastrips are regular Movie Strips that can be linked to a shot in kitsu. It is a good idea to create a separate meta strip in a separate channel that represents the shot. That gives you the freedom to assemble a shot out of multiple elements, like multiple storyboard pictures, and still have one metastrip that contains the full shot range.
![image info](/media/addons/blender_kitsu/metastrip.001.jpg) ![image info](/media/addons/blender_kitsu/metastrip.001.jpg)
@ -129,13 +129,13 @@ This will import a metastrip.mp4 (1000 frame black video) file which is saved in
3.1 Execute the `Initialize Shot` Operator. 3.1 Execute the `Initialize Shot` Operator.
3.2 Link this strip to a sequence with the `Link Sequence` operator or create a new seuence with the `Submit New Sequence` operator. 3.2 Link this strip to a sequence with the `Link Sequence` operator or create a new sequence with the `Submit New Sequence` operator.
3.3 Type in the name of the new shot in the `Shot` field 3.3 Type in the name of the new shot in the `Shot` field
3.4 Execute the `Submit New Shot` operator in the `Push` Panel (Will warn you if the shot already exists on Kitsu) 3.4 Execute the `Submit New Shot` operator in the `Push` Panel (Will warn you if the shot already exists on Kitsu)
>**Note**: Most of the operatos are selection sensitive. So you can do these operations for a batch of seqeuence strips. If you have nothing selected it will usually try to operate on all strips in the sequence editor. <br/> >**Note**: Most of the operator are selection sensitive. So you can do these operations for a batch of sequence strips. If you have nothing selected it will usually try to operate on all strips in the sequence editor. <br/>
![image info](/media/addons/blender_kitsu/sqe_init_selection.jpg) ![image info](/media/addons/blender_kitsu/sqe_init_selection.jpg)
##### Metadata ##### Metadata
@ -145,7 +145,7 @@ If you select a single linked strip you will see a `Metadata` panel that shows y
The frame range will be updated by using the Blender editing tools on the strip. (trimming, sliding, etc.). <br/> The frame range will be updated by using the Blender editing tools on the strip. (trimming, sliding, etc.). <br/>
If you execute the `Initialize Shot Start Frame` operator (refresh icon) the current in point of the strip will be remapped so the shot starts at 101 in the current editing state. <br/> If you execute the `Initialize Shot Start Frame` operator (refresh icon) the current in point of the strip will be remapped so the shot starts at 101 in the current editing state. <br/>
You can reassign the shot to another seqeunce by exeucting the `Link Sequence` Operator, change the shot name or the seqeuence color. <br/> You can reassign the shot to another sequence by executing the `Link Sequence` Operator, change the shot name or the sequence color. <br/>
If you linked in a sequence that has no `["data"]["color"]` attribute on Kitsu yet the gpu overlay line will be white. In order to add a new sequence color execute the `Add Sequence Color` operator. <br/> If you linked in a sequence that has no `["data"]["color"]` attribute on Kitsu yet the gpu overlay line will be white. In order to add a new sequence color execute the `Add Sequence Color` operator. <br/>
@ -201,10 +201,10 @@ If you check the `Advanced` checkbox next to the counter value, you have access
![image info](/media/addons/blender_kitsu/sqe_multi_edit_advanced.jpg) ![image info](/media/addons/blender_kitsu/sqe_multi_edit_advanced.jpg)
You can adjust the number of counter digits, the incrementation size and also the `Pattern` it will use to generate the shot name. <br/> You can adjust the number of counter digits, the increment size and also the `Pattern` it will use to generate the shot name. <br/>
>**Pattern**: supports 3 wildcards. `<Sequence>`, `<Counter>`, `<Project>` that can be used multiple times in any order. <br/> >**Pattern**: supports 3 wildcards. `<Sequence>`, `<Counter>`, `<Project>` that can be used multiple times in any order. <br/>
**Custom Sequence Variable**: specify a custom string that should be used in the `<Sequence>` wildcard instaed of the sequence name. <br/> **Custom Sequence Variable**: specify a custom string that should be used in the `<Sequence>` wildcard instead of the sequence name. <br/>
**Custom Project Variable**: specify a custom string that should be used in the `<Project>` wildcard instaed of the project name. <br/> **Custom Project Variable**: specify a custom string that should be used in the `<Project>` wildcard instead of the project name. <br/>
##### General Sequence Editor Tools ##### General Sequence Editor Tools
In the general tab you can find some tools that don't directly relate to Kitsu but are useful for editing. In the general tab you can find some tools that don't directly relate to Kitsu but are useful for editing.
@ -268,10 +268,10 @@ blender-kitsu makes good use of logging and status reports. Most of the operator
## Credits ## Credits
This project uses gazu as a submodule to interact with the gazu data base. Gazu is written by CG Wire, a company based in France. This project uses gazu as a submodule to interact with the gazu data base. Gazu is written by CG Wire, a company based in France.
- dazu repo: https://github.com/cgwire/gazu - gazu repo: https://github.com/cgwire/gazu
- gazu doc : https://gazu.cg-wire.com/ - gazu doc : https://gazu.cg-wire.com/
The file at ./blender_kitsu/sqe/draw.py is copied and modified from the blender-cloud-addon (https://developer.blender.org/diffusion/BCA/). The file at ./blender_kitsu/sqe/draw.py is copied and modified from the blender-cloud-addon (https://projects.blender.org/archive/blender-cloud-addon).
Original author of this file is: Sybren A. Stuevel. Original author of this file is: Sybren A. Stuevel.