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

Today

Aaron Carlisle (Blendify) closed D5547: Tiny file path mistake in the document..
Thu, Aug 22, 12:28 AM · Documentation
Aaron Carlisle (Blendify) closed D5548: Wrong shortcut of lasso deselection..
Thu, Aug 22, 12:26 AM · Documentation
D5547: Tiny file path mistake in the document. is now accepted and ready to land.
Thu, Aug 22, 12:25 AM · Documentation
D5548: Wrong shortcut of lasso deselection. is now accepted and ready to land.
Thu, Aug 22, 12:24 AM · Documentation

Yesterday

Yevgeny Makarov (jenkm) closed T55453: How to make blender portable/self-contained is not documented as Resolved.
Wed, Aug 21, 5:18 PM · Documentation
Yevgeny Makarov (jenkm) claimed T55453: How to make blender portable/self-contained is not documented.
Wed, Aug 21, 5:17 PM · Documentation
Masayuki Osaka (oimo1979) added a comment to D5548: Wrong shortcut of lasso deselection..

Oh...
@Bastien Montagne (mont29)
Thank you for your advice.

Wed, Aug 21, 1:08 PM · Documentation
Bastien Montagne (mont29) edited reviewers for D5547: Tiny file path mistake in the document., added: Aaron Carlisle (Blendify); removed: Documentation.
Wed, Aug 21, 12:11 PM · Documentation
Bastien Montagne (mont29) edited reviewers for D5548: Wrong shortcut of lasso deselection., added: Aaron Carlisle (Blendify); removed: Documentation.
Wed, Aug 21, 12:10 PM · Documentation
Bastien Montagne (mont29) added a comment to D5548: Wrong shortcut of lasso deselection..

Please do not add whole projects as subscribers or reviewers, this adds way too much noise for way too much people.

Wed, Aug 21, 12:09 PM · Documentation
Bastien Montagne (mont29) added a comment to T68588: Blender: Going Locale.

Note that you cannot really get rid of the svn repo for Blender UI translations, as those stored in GIT are fully stripped to be as small as possible, they are essentially useless as working translation material...

What is the reason for this? Is this to reduce the size of the generated Machine Object files? If so cant this be consider a part of the build process?

Wed, Aug 21, 10:36 AM · Documentation, BF Blender, Translations, Infrastructure: Websites
Masayuki Osaka (oimo1979) created D5548: Wrong shortcut of lasso deselection..
Wed, Aug 21, 6:24 AM · Documentation
Masayuki Osaka (oimo1979) created D5547: Tiny file path mistake in the document..
Wed, Aug 21, 2:59 AM · Documentation

Tue, Aug 20

Aaron Carlisle (Blendify) closed D5538: Documentation: History Update.
Tue, Aug 20, 11:51 PM · Documentation
D5538: Documentation: History Update is now accepted and ready to land.
Tue, Aug 20, 11:51 PM · Documentation
Aaron Carlisle (Blendify) added a comment to D5538: Documentation: History Update.

@Eduardo Pujol (EdPS) thank you for the contributions, please feel to keep up the good work.

Tue, Aug 20, 11:49 PM · Documentation
Aaron Carlisle (Blendify) closed D5539: Add Blender version in Add-on Tutorial.
Tue, Aug 20, 11:30 PM · Documentation
Eduardo Pujol (EdPS) added a comment to D5538: Documentation: History Update.

I am new here as a contributor. I just started learning Blender and I am reading the docs from the start. Feel free to change the wording of my proposition.

Tue, Aug 20, 10:20 PM · Documentation
Brecht Van Lommel (brecht) added a reviewer for D5538: Documentation: History Update: Aaron Carlisle (Blendify).
Tue, Aug 20, 6:33 PM · Documentation
Brecht Van Lommel (brecht) added a reviewer for D5539: Add Blender version in Add-on Tutorial: Aaron Carlisle (Blendify).
Tue, Aug 20, 6:33 PM · Documentation
Jonathan Giroux (Koltes) created D5539: Add Blender version in Add-on Tutorial.
Tue, Aug 20, 2:46 PM · Documentation
Eduardo Pujol (EdPS) created D5538: Documentation: History Update.
Tue, Aug 20, 2:13 PM · Documentation
Yevgeny Makarov (jenkm) added a comment to T68858: Application template splash screen documentation gives the wrong dimensions.

https://docs.blender.org/manual/en/dev/advanced/app_templates.html

Tue, Aug 20, 8:11 AM · Documentation
Andrew Charlton (Scaredyfish) edited projects for T68858: Application template splash screen documentation gives the wrong dimensions, added: Documentation; removed Add-ons.
Tue, Aug 20, 6:37 AM · Documentation

Mon, Aug 19

Nathan Craddock (Zachman) closed D5515: Update Outliner editor.
Mon, Aug 19, 5:39 PM · Documentation
Nathan Craddock (Zachman) added inline comments to D5515: Update Outliner editor.
Mon, Aug 19, 5:37 PM · Documentation

Sun, Aug 18

D5515: Update Outliner editor is now accepted and ready to land.

Accepting, only minor edits needed.

Sun, Aug 18, 4:09 PM · Documentation
D5515: Update Outliner editor now requires changes to proceed.
Sun, Aug 18, 4:09 PM · Documentation
Yevgeny Makarov (jenkm) closed T55270: Duplication of Mirror Vertex Group description as Resolved.
Sun, Aug 18, 3:18 PM · Documentation
Yevgeny Makarov (jenkm) closed T51302: "Boid" Force field does nothing; should be removed as Resolved.
Sun, Aug 18, 3:18 PM · Documentation, Physics, BF Blender
D5515: Update Outliner editor is now accepted and ready to land.

I've added you to the Documentation project to commit this yourself. Username and password is the same as developer.blender.org.

Sun, Aug 18, 3:50 AM · Documentation
Brecht Van Lommel (brecht) added a member for Documentation: Nathan Craddock (Zachman).
Sun, Aug 18, 3:44 AM
Nathan Craddock (Zachman) added a project to D5515: Update Outliner editor: Documentation.
Sun, Aug 18, 12:58 AM · Documentation

Sat, Aug 17

Aaron Carlisle (Blendify) added a member for Documentation: Jens Arnold (j.a-b).
Sat, Aug 17, 12:03 AM
Aaron Carlisle (Blendify) added a comment to T68704: Documentation: explain that Blender 2.80 Exporting a textured OBJ with any shader other than Principled BSDF will result in an MTL without map_Kd pointing to texture file.

@Philipp Oeser (lichtwerk) you now have commit rights.

Sat, Aug 17, 12:02 AM · Documentation, Import/Export, Add-ons
Aaron Carlisle (Blendify) added a member for Documentation: Philipp Oeser (lichtwerk).
Sat, Aug 17, 12:01 AM

Fri, Aug 16

Aaron Carlisle (Blendify) moved T68738: Text Editor (Missing Documentation) from Backlog to Missing documentation on the Documentation board.
Fri, Aug 16, 11:59 PM · Documentation
Aaron Carlisle (Blendify) moved T68709: Missing Gizmo information in the API documentation from Backlog to Python API on the Documentation board.
Fri, Aug 16, 11:55 PM · Documentation
Yevgeny Makarov (jenkm) created T68738: Text Editor (Missing Documentation).
Fri, Aug 16, 5:01 PM · Documentation
Bastien Montagne (mont29) added a comment to T68704: Documentation: explain that Blender 2.80 Exporting a textured OBJ with any shader other than Principled BSDF will result in an MTL without map_Kd pointing to texture file.

It is plainly impossible to export any kind of node-based shading system into a fixed-pipeline thing like MTL or FBX formats suport. That’s just basic common sense. We can only offer some very limited approximation in some well-defined cases. Note that 2.7x did not export node-based materials at all.

Fri, Aug 16, 4:33 PM · Documentation, Import/Export, Add-ons
Luke Meeken (lmeeken) added a comment to T68704: Documentation: explain that Blender 2.80 Exporting a textured OBJ with any shader other than Principled BSDF will result in an MTL without map_Kd pointing to texture file.

If it is a(n undocumented) design choice, it is different from the design choice in 2.7 versions of Blender, which exported a usable .mtl . It also feels like an ill-advised design choice as it depends on a workaround outside of the program itself (manually adding the map_Kt line to the mtl in a text editor) to "remedy."

Fri, Aug 16, 3:45 PM · Documentation, Import/Export, Add-ons
Yevgeny Makarov (jenkm) added a revision to T55270: Duplication of Mirror Vertex Group description: D5502: Documentation: Mirror Vertex Group.
Fri, Aug 16, 3:04 PM · Documentation
Bastien Montagne (mont29) closed T68704: Documentation: explain that Blender 2.80 Exporting a textured OBJ with any shader other than Principled BSDF will result in an MTL without map_Kd pointing to texture file as Resolved by committing rBM5715: Fix T68704: Add info about material wrapper for IO addons..
Fri, Aug 16, 11:44 AM · Documentation, Import/Export, Add-ons
Philipp Oeser (lichtwerk) renamed T68704: Documentation: explain that Blender 2.80 Exporting a textured OBJ with any shader other than Principled BSDF will result in an MTL without map_Kd pointing to texture file from Blender 2.80 Exporting a textured OBJ with any shader other than Principled BSDF results in an MTL without map_Kd pointing to texture file to Documentation: explain that Blender 2.80 Exporting a textured OBJ with any shader other than Principled BSDF will result in an MTL without map_Kd pointing to texture file.
Fri, Aug 16, 9:53 AM · Documentation, Import/Export, Add-ons
Philipp Oeser (lichtwerk) edited projects for T68704: Documentation: explain that Blender 2.80 Exporting a textured OBJ with any shader other than Principled BSDF will result in an MTL without map_Kd pointing to texture file, added: Add-ons, Import/Export, Documentation; removed BF Blender.

This is a design choice, yes.

Fri, Aug 16, 9:52 AM · Documentation, Import/Export, Add-ons

Thu, Aug 15

Cédric (Clarkx) created T68709: Missing Gizmo information in the API documentation.
Thu, Aug 15, 10:29 PM · Documentation
Campbell Barton (campbellbarton) closed T68688: Manual shortcut typo for chapter: Sculpting & Painting » Brush » Stroke » Curve Add Points as Resolved by committing rBM5710: Fix T68688: Manual shortcut typo for Sculpting & Painting > Brush > Stroke >….
Thu, Aug 15, 1:37 PM · Documentation
Christoph Werner (Taros) created T68688: Manual shortcut typo for chapter: Sculpting & Painting » Brush » Stroke » Curve Add Points.
Thu, Aug 15, 12:30 PM · Documentation

Wed, Aug 14

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

user registration - possible to use phabricator user database? Or some other way to keep these in sync?

Wed, Aug 14, 11:52 PM · Documentation, BF Blender, Translations, Infrastructure: Websites
Aaron Carlisle (Blendify) updated the task description for T68588: Blender: Going Locale.
Wed, Aug 14, 10:54 PM · Documentation, BF Blender, Translations, Infrastructure: Websites