The inclusion of the command table makes a massive amount of data untransferable to another language #104678

Closed
opened 2024-01-13 09:44:05 +01:00 by Hoang Duy Tran · 3 comments
Member

Page Information
File: manual/addons/3d_view/precision_drawing_tools/begin.rst
Blender Version: 4.0
Documentation Language: en
Permanent Link

Short description of error
On this page:

https://docs.blender.org/manual/en/latest/addons/3d_view/precision_drawing_tools/begin.html#setting-the-cursor-pivot-point-movement-mode

This table in particular
https://docs.blender.org/manual/en/latest/_images/addons_pdt_setup_4.png

I personally don't think this is fair and useful. It's just a mean to cut down amount of typing for documenter but the image became a complete meaningless figure for users from a different language than English.

**Page Information** File: `manual/addons/3d_view/precision_drawing_tools/begin.rst` Blender Version: `4.0` Documentation Language: `en` [Permanent Link](https://docs.blender.org/manual/en/4.0/addons/3d_view/precision_drawing_tools/begin.html) **Short description of error** On this page: https://docs.blender.org/manual/en/latest/addons/3d_view/precision_drawing_tools/begin.html#setting-the-cursor-pivot-point-movement-mode This table in particular https://docs.blender.org/manual/en/latest/_images/addons_pdt_setup_4.png I personally don't think this is fair and useful. It's just a mean to cut down amount of typing for documenter but the image became a complete meaningless figure for users from a different language than English.
Hoang Duy Tran added the
Priority
Normal
Type
Report
Status
Needs Triage
labels 2024-01-13 09:44:05 +01:00
Member

Add-on documentation is largely up to the add-on developers.

For example, the documentation for this add-on is just copied from here:
https://github.com/Clockmender/Precision-Drawing-Tools/wiki/03-Before-You-Begin.

With the future addition of the Blender Extensions Platform add-on documentation like this one will be fully maintained by the 3rd party.

That being said I believe fixing this particular table is outside this documentation project's scope.

Also, there are plans to be able to have translatable images see #66212

Add-on documentation is largely up to the add-on developers. For example, the documentation for this add-on is just copied from here: https://github.com/Clockmender/Precision-Drawing-Tools/wiki/03-Before-You-Begin. With the future addition of the [Blender Extensions Platform](https://code.blender.org/2022/10/blender-extensions-platform/) add-on documentation like this one will be fully maintained by the 3rd party. That being said I believe fixing this particular table is outside this documentation project's scope. Also, there are plans to be able to have translatable images see https://projects.blender.org/blender/blender-manual/issues/66212
Blender Bot added
Status
Archived
and removed
Status
Needs Triage
labels 2024-01-14 19:55:49 +01:00
Aaron Carlisle added
Type
Known Issue
and removed
Type
Report
labels 2024-01-14 19:56:07 +01:00
Author
Member

Thank you @Blendify, I don't know if it is relevant or not, but I used the Live Text feature of my iPhone to OCR then copied to Note, then transfer to Numbers app as a table, save as CSV, then use this page:

https://tableconvert.com/csv-to-restructuredtext

to convert to RST table, and here is the data in RST text:

Precision Drawing Tools - Available Options
+---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+
| COMMANDS | Cursor | Pivot Point | Move | New Vertex | Extrude Vertices | Split Edges | Duplicate Geometry | Extrude Geometry |
+=====================+===========+=============+======+============+==================+=============+====================+==================+
| Absolute (Edit) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No |
| Absolute (Object) | Yes | Yes | Yes | No | No | No | No | No |
| Delta (Edit) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Delta (Object) | Yes | Yes | Yes | No | No | No | No | No |
| Direction (Edit) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
| Direction (Object) | Yes | Yes | Yes | No | No | No | No | No |
| Percent (Edit) | Yes | Yes | Yes | Yes | Yes | Yes | No | No |
| Percent (Object) | Yes | Yes | Yes | No | No | No | No | No |
| Normal (Edit) | Yes | Yes | Yes | Yes | Yes | No | No | No |
| Normal (Object) | Yes | Yes | Yes | No | No | No | No | No |
| Arc Centre (Edit) | Yes | Yes | Yes | Yes | Yes | No | No | No |
| Arc Centre (Object) | Yes | Yes | Yes | No | No | No | No | No |
| Intersect (Edit) | Yes | Yes | Yes | Yes | Yes | | No | No |
| Intersect (Object) | Yes | Yes | Yes | No | No | | No | No |
+---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+
| TOOLS | Edit Mode | Object Mode | | | | | | |
+---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+
| Join 2 Verts | Yes | No | | | | | | |
| Origin To Cursor | Yes | Yes | | | | | | |
| Set A/D 2D | Yes | Yes | | | | | | |
| Set A/D 3D | Yes | Yes | | | | | | |
| Taper | Yes | No | | | | | | |
| Fillet | Yes | No | | | | | | |
+---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+
| PIVOT POINT | Edit Mode | Object Mode | | | | | | |
+---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+
| Show/Hide | Yes | Yes | | | | | | |
| Selection | Yes | No | | | | | | |
| Cursor | Yes | Yes | | | | | | |
| Origin | Yes | Yes | | | | | | |
| Rotate | Yes | No | | | | | | |
| Scale | Yes | No | | | | | | |
| Cursor To Pivot | Yes | Yes | | | | | | |
| PP Write | Yes | Yes | | | | | | |
| PP Read | Yes | Yes | | | | | | |
+---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+

Thank you @Blendify, I don't know if it is relevant or not, but I used the Live Text feature of my iPhone to OCR then copied to Note, then transfer to Numbers app as a table, save as CSV, then use this page: https://tableconvert.com/csv-to-restructuredtext to convert to RST table, and here is the data in RST text: Precision Drawing Tools - Available Options +---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+ | COMMANDS | Cursor | Pivot Point | Move | New Vertex | Extrude Vertices | Split Edges | Duplicate Geometry | Extrude Geometry | +=====================+===========+=============+======+============+==================+=============+====================+==================+ | Absolute (Edit) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | No | | Absolute (Object) | Yes | Yes | Yes | No | No | No | No | No | | Delta (Edit) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | Delta (Object) | Yes | Yes | Yes | No | No | No | No | No | | Direction (Edit) | Yes | Yes | Yes | Yes | Yes | Yes | Yes | Yes | | Direction (Object) | Yes | Yes | Yes | No | No | No | No | No | | Percent (Edit) | Yes | Yes | Yes | Yes | Yes | Yes | No | No | | Percent (Object) | Yes | Yes | Yes | No | No | No | No | No | | Normal (Edit) | Yes | Yes | Yes | Yes | Yes | No | No | No | | Normal (Object) | Yes | Yes | Yes | No | No | No | No | No | | Arc Centre (Edit) | Yes | Yes | Yes | Yes | Yes | No | No | No | | Arc Centre (Object) | Yes | Yes | Yes | No | No | No | No | No | | Intersect (Edit) | Yes | Yes | Yes | Yes | Yes | | No | No | | Intersect (Object) | Yes | Yes | Yes | No | No | | No | No | +---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+ | TOOLS | Edit Mode | Object Mode | | | | | | | +---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+ | Join 2 Verts | Yes | No | | | | | | | | Origin To Cursor | Yes | Yes | | | | | | | | Set A/D 2D | Yes | Yes | | | | | | | | Set A/D 3D | Yes | Yes | | | | | | | | Taper | Yes | No | | | | | | | | Fillet | Yes | No | | | | | | | +---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+ | PIVOT POINT | Edit Mode | Object Mode | | | | | | | +---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+ | Show/Hide | Yes | Yes | | | | | | | | Selection | Yes | No | | | | | | | | Cursor | Yes | Yes | | | | | | | | Origin | Yes | Yes | | | | | | | | Rotate | Yes | No | | | | | | | | Scale | Yes | No | | | | | | | | Cursor To Pivot | Yes | Yes | | | | | | | | PP Write | Yes | Yes | | | | | | | | PP Read | Yes | Yes | | | | | | | +---------------------+-----------+-------------+------+------------+------------------+-------------+--------------------+------------------+
Blender Bot added
Status
Confirmed
and removed
Status
Archived
labels 2024-01-15 00:23:10 +01:00
Member

I couldn't get sphinx to like the table. This is more work than it is worth, I'm closing the issue.

Translation of add-on documentation is not a priority at the moment.

I couldn't get sphinx to like the table. This is more work than it is worth, I'm closing the issue. Translation of add-on documentation is not a priority at the moment.
Blender Bot added
Status
Archived
and removed
Status
Confirmed
labels 2024-01-20 01:12:20 +01:00
Sign in to join this conversation.
No Milestone
No project
No Assignees
2 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: blender/blender-manual#104678
No description provided.