Page MenuHome

DocumentationProject
ActivePublic

Details

Description

Blender Documentation (latest manual build)

Welcome to the Blender User Documentation project. We are actively searching for contributors and documentation module owners.

The Blender Manual is written using reStructuredText (RST) and is built with Sphinx.

If you want to start contributing or want to have a look at the manual, here we have some instructions.

How to build & edit the docs locally

Before you start contributing it may be helpful to read the style guides which give instructions on how to write with RST and some goals of the manual.

Now that you are familiar with the process, you can get setup, edit, and contribute your changes by following these links:

  1. Install
  2. Build
  3. Edit
  4. Build again
  5. Patch or Commit
NOTE: We realize this may be intimidating if you're not familiar with Subversion or making patches, you may also submit the modified file as a Phabricator task, or mail the bf-docboard mailing list.

Links

Manual Docs: Manual/About (the process for editing the manual).
Source Files: Manual Repository (subversion repository).
Mailing List: bf-docboard
Administrators: @Aaron Carlisle (Blendify) @Francesco Siddi (fsiddi)


Documentation Team

The coordination of the Blender Manual is run by a set of Administrators,
which are responsible for managing the whole project and infrastructures. (listed above)

If you are interested in becoming a contributor, please contact us on the bf-docboard mailing list.

Translations

For translations, we use Sphinx’s internationalization package. To get started see https://docs.blender.org/manual/en/dev/about/contribute/index.html#translations

Links

Source Files: Translation's Repository (subversion repository).
Forum: Documentation category on Developer Talk
Mailing List: bf-docboard
Administrators: @Aaron Carlisle (Blendify) , @Francesco Siddi (fsiddi)

NOTE: If you are a new translator who wants to start translating a new language that is not listed below send and email to the bf-docboard and we would be glad to set it up for you.

Recent Activity

Fri, Sep 20

Germano Cavalcante (mano-wii) triaged T69628: There's an undocumented nonsensical collections section in the rigid body options (just below the sensitivity settings) as Confirmed, Medium priority.
Fri, Sep 20, 7:55 PM · Documentation, Physics, BF Blender
Antonin (Antoninhs) added a comment to T70105: Transform orientation shortcut wrong in documentation.

There is currently no shortcuts for the 2.7x keymap

Fri, Sep 20, 5:04 PM · Documentation
Philipp Oeser (lichtwerk) removed a project from T70105: Transform orientation shortcut wrong in documentation: BF Blender.
Fri, Sep 20, 2:56 PM · Documentation
Philipp Oeser (lichtwerk) renamed T70105: Transform orientation shortcut wrong in documentation from Transform orientation shortcut wrong in documetation to Transform orientation shortcut wrong in documentation.
Fri, Sep 20, 2:56 PM · Documentation
Philipp Oeser (lichtwerk) renamed T70105: Transform orientation shortcut wrong in documentation from Transform orientation shortcut to Transform orientation shortcut wrong in documetation.
Fri, Sep 20, 2:55 PM · Documentation
Philipp Oeser (lichtwerk) added a comment to T70105: Transform orientation shortcut wrong in documentation.

Shortcut is , now afaict.
The bug assigning the other shortcut is T65397: Assigning shortcut to editor properties gives errors

Fri, Sep 20, 2:55 PM · Documentation
Jacques Lucke (JacquesLucke) added a project to T70105: Transform orientation shortcut wrong in documentation: Documentation.
Fri, Sep 20, 1:33 PM · Documentation

Thu, Sep 19

Martin Capitanio (capnm) added a comment to T70041: Rotate around bounding box center poorly documented.

No bbox of the object is ever used, so why show it as such?

Take it as brain training for the new fake-news world. Once you get what it really does, you can simply ignore what it says :-)

Thu, Sep 19, 8:43 AM · Documentation
Paul Melis (paulmelis) added a comment to T70041: Rotate around bounding box center poorly documented.

Right, so in object mode and edit mode the behaviour is different (bbox of object centers, versus bbox of selected vertices/edges/faces). So I still think the first picture on that page ("Relationship between an Object and its Bounding Box") is putting readers on the wrong foot. No bbox of the object is ever used, so why show it as such? If it is to explain the concept of a bounding box then showing the bbox of objects centers would make more sense.

Thu, Sep 19, 7:33 AM · Documentation
Campbell Barton (campbellbarton) added a comment to T70041: Rotate around bounding box center poorly documented.

While this could work differently this is working as intended.

Thu, Sep 19, 1:07 AM · Documentation

Wed, Sep 18

Paul Melis (paulmelis) created T70041: Rotate around bounding box center poorly documented.
Wed, Sep 18, 10:49 PM · Documentation

Mon, Sep 16

Aaron Carlisle (Blendify) added a comment to T68588: Blender: Going Locale.

The only reason is to help do the changes I described but if you would like to stay on top of things instead that works too.

Mon, Sep 16, 9:17 PM · Documentation, BF Blender, Translations, Infrastructure: Websites

Sat, Sep 14

zdy (NGENNGT) added a member for Documentation: Kinyu Wu (Mr_Kin).
Sat, Sep 14, 1:34 AM

Fri, Sep 13

Aaron Carlisle (Blendify) assigned T68050: Online Manual / Online Python reference fails for anything related to CyclesRenderSettings to Campbell Barton (campbellbarton).
Fri, Sep 13, 8:55 PM · User Interface, Cycles, Python, Documentation, BF Blender
Aaron Carlisle (Blendify) moved T68588: Blender: Going Locale from Backlog to Administrative on the Documentation board.
Fri, Sep 13, 8:54 PM · Documentation, BF Blender, Translations, Infrastructure: Websites
Aaron Carlisle (Blendify) moved T68432: Blender Documentation Release Cycle from Backlog to Administrative on the Documentation board.
Fri, Sep 13, 8:54 PM · Documentation
zdy (NGENNGT) added projects to T69840: curve handle colors viewport display inconsistent with theme settings: User Interface, Documentation.
Fri, Sep 13, 1:49 PM · User Interface, BF Blender

Tue, Sep 10

Aaron Carlisle (Blendify) accepted D5721: Corrected description of Cycles' environment baking.
Tue, Sep 10, 2:50 PM · Documentation

Mon, Sep 9

Brecht Van Lommel (brecht) added a member for Documentation: Omar Emara (OmarSquircleArt).
Mon, Sep 9, 5:48 PM
D5721: Corrected description of Cycles' environment baking is now accepted and ready to land.
Mon, Sep 9, 4:27 PM · Documentation
Bastien Montagne (mont29) added a comment to D5721: Corrected description of Cycles' environment baking.

Please *DO NOT* put projects as reviewers, this is generating lots of mail noise for lost of people!

Mon, Sep 9, 2:07 PM · Documentation
Bastien Montagne (mont29) removed a reviewer for D5721: Corrected description of Cycles' environment baking: Documentation.
Mon, Sep 9, 2:07 PM · Documentation
K Hsiao (iceblue) retitled D5721: Corrected description of Cycles' environment baking from Documentation: Corrected description of Cycles' environment baking to Corrected description of Cycles' environment baking.
Mon, Sep 9, 8:41 AM · Documentation
K Hsiao (iceblue) created D5721: Corrected description of Cycles' environment baking.
Mon, Sep 9, 8:39 AM · Documentation

Sun, Sep 8

William Reynish (billreynish) added a comment to T69628: There's an undocumented nonsensical collections section in the rigid body options (just below the sensitivity settings).

Indeed, we probably should just use regular Collections here.

Sun, Sep 8, 8:53 PM · Documentation, Physics, BF Blender
Aaron Carlisle (Blendify) moved T69628: There's an undocumented nonsensical collections section in the rigid body options (just below the sensitivity settings) from Backlog to Missing documentation on the Documentation board.
Sun, Sep 8, 2:15 AM · Documentation, Physics, BF Blender
Aaron Carlisle (Blendify) added projects to T69628: There's an undocumented nonsensical collections section in the rigid body options (just below the sensitivity settings): Physics, Documentation.

Rigid bodies can be configured to only be affected by certain collections. This is very briefly mentioned here: https://docs.blender.org/manual/en/latest/physics/rigid_body/world.html

Sun, Sep 8, 2:14 AM · Documentation, Physics, BF Blender

Sat, Sep 7

Aaron Carlisle (Blendify) moved T69590: Can not find Bézier Curve article with Bezier key word in Documentation from Backlog to Administrative on the Documentation board.
Sat, Sep 7, 3:25 AM · Documentation
Aaron Carlisle (Blendify) added a comment to T69590: Can not find Bézier Curve article with Bezier key word in Documentation.

Reported this to sphinx upstream, https://github.com/sphinx-doc/sphinx/issues/6687

Sat, Sep 7, 3:24 AM · Documentation
Dan McGrath (dmcgrath) added a comment to T69466: Manual: Archive 404.

Create a file called .htaccess in the top directory of the output html files for the language with the contents:

Sat, Sep 7, 2:57 AM · Documentation
Tobias Heinke (TobiasH) added a comment to T69466: Manual: Archive 404.

I don't know anything about Apache.

Sat, Sep 7, 1:07 AM · Documentation

Fri, Sep 6

John Doe (mevsme) created T69590: Can not find Bézier Curve article with Bezier key word in Documentation.
Fri, Sep 6, 5:10 PM · Documentation

Wed, Sep 4

Dan McGrath (dmcgrath) added a comment to T69466: Manual: Archive 404.

It would appear that we cannot use ErrorDocument Apache directives in a <Location> context. To manually do this, we could have to define a hard-coded path for each language and version combination. Clearly this doesn't work well over time!

Wed, Sep 4, 7:37 PM · Documentation
Tobias Heinke (TobiasH) added a project to T69466: Manual: Archive 404: Documentation.
Wed, Sep 4, 12:59 AM · Documentation

Tue, Sep 3

Aaron Carlisle (Blendify) added a comment to D5638: Various fixes.

I just closed it for you.

Tue, Sep 3, 4:48 PM · Documentation
Aaron Carlisle (Blendify) created T69449: Update IO Addons.
Tue, Sep 3, 4:29 PM · Documentation
Campbell Barton (campbellbarton) updated the task description for T55362: Blender development todo list -- Tools (migrated from wiki).
Tue, Sep 3, 7:47 AM · Documentation
Campbell Barton (campbellbarton) updated the task description for T55362: Blender development todo list -- Tools (migrated from wiki).
Tue, Sep 3, 7:38 AM · Documentation
Campbell Barton (campbellbarton) renamed T55362: Blender development todo list -- Tools (migrated from wiki) from Blender development todo list -- Tools to Blender development todo list -- Tools (migrated from wiki).
Tue, Sep 3, 7:37 AM · Documentation
Campbell Barton (campbellbarton) updated the task description for T55362: Blender development todo list -- Tools (migrated from wiki).
Tue, Sep 3, 4:14 AM · Documentation
Campbell Barton (campbellbarton) updated the task description for T55362: Blender development todo list -- Tools (migrated from wiki).
Tue, Sep 3, 4:11 AM · Documentation

Mon, Sep 2

Bastien Montagne (mont29) added a comment to T68588: Blender: Going Locale.

I’d rather stay in charge of translation project, including which languages we keep or not… If es and es_ES are identical, then indeed the later should have been removed for a long time.

Mon, Sep 2, 3:31 PM · Documentation, BF Blender, Translations, Infrastructure: Websites
Campbell Barton (campbellbarton) updated the task description for T55362: Blender development todo list -- Tools (migrated from wiki).
Mon, Sep 2, 11:26 AM · Documentation
Campbell Barton (campbellbarton) updated the task description for T55362: Blender development todo list -- Tools (migrated from wiki).
Mon, Sep 2, 11:25 AM · Documentation
Gabriel Gazzán (gab3d) added a comment to T68588: Blender: Going Locale.

es and es_ES are identical, I propose we remove es_ES

Mon, Sep 2, 2:43 AM · Documentation, BF Blender, Translations, Infrastructure: Websites
Val Acar (valacar) added a comment to D5638: Various fixes.

@Val Acar (valacar) I have given you commit access so you can feel free to push these changes yourself.

Mon, Sep 2, 1:31 AM · Documentation
D5638: Various fixes is now accepted and ready to land.

@Val Acar (valacar) I have given you commit access so you can feel free to push these changes yourself.

Mon, Sep 2, 12:42 AM · Documentation
Aaron Carlisle (Blendify) added a member for Documentation: Val Acar (valacar).
Mon, Sep 2, 12:41 AM
Val Acar (valacar) added a reviewer for D5638: Various fixes: Aaron Carlisle (Blendify).
Mon, Sep 2, 12:28 AM · Documentation

Sun, Sep 1

Aaron Carlisle (Blendify) added a comment to T68588: Blender: Going Locale.

Somethings I noticed while testing UI translations:

Sun, Sep 1, 11:48 PM · Documentation, BF Blender, Translations, Infrastructure: Websites