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.
This project aims at replacing and updating the current Blender Manual.

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

Tue, May 22

bdp (budip) added a comment to T55018: Documentation for 2.8 (WIP).

3D view : Support mixed snap https://developer.blender.org/D3400

Tue, May 22, 2:37 PM · Documentation
bdp (budip) added a comment to T55018: Documentation for 2.8 (WIP).

cycles: bevel shader https://developer.blender.org/D2803

Tue, May 22, 3:26 AM · Documentation

Mon, May 14

Aaron Carlisle (Blendify) updated the task description for T55018: Documentation for 2.8 (WIP).
Mon, May 14, 2:06 PM · Documentation
bdp (budip) added a comment to T55018: Documentation for 2.8 (WIP).

cycles :random walk subsurface scattering https://developer.blender.org/D3054

Mon, May 14, 4:03 AM · Documentation

Sun, May 13

bdp (budip) added a comment to T55018: Documentation for 2.8 (WIP).

new npr node https://developer.blender.org/D3205

Sun, May 13, 9:26 AM · Documentation
Aaron Carlisle (Blendify) updated the task description for T55018: Documentation for 2.8 (WIP).
Sun, May 13, 2:55 AM · Documentation
Aaron Carlisle (Blendify) updated the task description for T55018: Documentation for 2.8 (WIP).
Sun, May 13, 2:51 AM · Documentation
Aaron Carlisle (Blendify) updated the task description for T55018: Documentation for 2.8 (WIP).
Sun, May 13, 2:48 AM · Documentation

Sat, May 12

bdp (budip) added a comment to T55018: Documentation for 2.8 (WIP).

+ Fracture Modifier

Sat, May 12, 10:41 AM · Documentation

Thu, May 10

Aaron Carlisle (Blendify) added a comment to T55018: Documentation for 2.8 (WIP).
Thu, May 10, 5:03 AM · Documentation
Aaron Carlisle (Blendify) added a comment to T55018: Documentation for 2.8 (WIP).

Does some names have changed or are they different things:
Toolbar or Topbar, Workbench or Workspace?

Thu, May 10, 5:03 AM · Documentation
Tobias Heinke (TobiasH) added a comment to T55018: Documentation for 2.8 (WIP).

some additions from my list (not confirmed, outdated):

  • Proxy/override system
  • Asset manager
  • Outliner refactor
  • Gsoc projects: Custom normal edit, new UV tools?
  • Fluid/smoke - Mantaflow?
Thu, May 10, 3:06 AM · Documentation

Wed, May 9

Aaron Carlisle (Blendify) updated the task description for T55018: Documentation for 2.8 (WIP).
Wed, May 9, 8:06 PM · Documentation
Aaron Carlisle (Blendify) triaged T55018: Documentation for 2.8 (WIP) as Confirmed priority.
Wed, May 9, 8:06 PM · Documentation
Aaron Carlisle (Blendify) closed D3196: Fix Documentation: Color Management - formula formatting misleading / wrong (T54920).
Wed, May 9, 3:53 AM · Documentation
Aaron Carlisle (Blendify) closed T54920: Documentation: Color Management - formula formatting misleading / wrong as Resolved by committing rBM4247: Fix T54920: Color Management - formula formatting misleading / wrong.
Wed, May 9, 3:53 AM · Documentation

Tue, May 8

Aaron Carlisle (Blendify) accepted D3196: Fix Documentation: Color Management - formula formatting misleading / wrong (T54920).

Looks good, I will commit tonight after I finish some of my other work.

Tue, May 8, 11:11 PM · Documentation
Adam Kalisz (blender_ei) updated the diff for D3196: Fix Documentation: Color Management - formula formatting misleading / wrong (T54920).

Changed "stops" to "exposure" in the formula.

Tue, May 8, 11:09 PM · Documentation
Adam Kalisz (blender_ei) updated the diff for D3196: Fix Documentation: Color Management - formula formatting misleading / wrong (T54920).

After checking with @Aaron Carlisle (Blendify) on IRC, I have updated the diff to actually be more descriptive (somewhat a mix between first and second revision). Keep in mind, that Windows has trouble with the multiplication symbol (file upload of the .diff doesnt work then on differential as well!).

Tue, May 8, 11:04 PM · Documentation

Mon, May 7

Adam Kalisz (blender_ei) updated the diff for D3196: Fix Documentation: Color Management - formula formatting misleading / wrong (T54920).

Simplified commit for T54920 to merely fix the parenthesis instead of adding new information into the formula

Mon, May 7, 11:45 PM · Documentation

Fri, May 4

Aaron Carlisle (Blendify) updated the task description for T48096: New Wiki.
Fri, May 4, 4:25 AM · Documentation, Infrastructure: Websites
Aaron Carlisle (Blendify) added a comment to T48096: New Wiki.

I think after the 2.8 release should be a good time for this even if we use the default wiki skin.

Fri, May 4, 4:23 AM · Documentation, Infrastructure: Websites

Thu, May 3

Dan McGrath (dmcgrath) added a comment to T48096: New Wiki.

I was about to update the new wiki, move/copy more stuff from the old wiki, I can log in using the credentials from the old wiki but I dont have editing permissions in the new wiki.
Could somebody set this up for me [or tell me how to do it myself]?
Thx in advance!

Thu, May 3, 5:09 PM · Documentation, Infrastructure: Websites
Philipp Oeser (lichtwerk) added a comment to T48096: New Wiki.

I was about to update the new wiki, move/copy more stuff from the old wiki, I can log in using the credentials from the old wiki but I dont have editing permissions in the new wiki.
Could somebody set this up for me [or tell me how to do it myself]?
Thx in advance!

Thu, May 3, 10:45 AM · Documentation, Infrastructure: Websites
Friedemann Seebass (frisee) added a comment to T53838: Link to "demo_file.zip" in chapter "Vehicle Controller Physics" of the user manual is broken..

Hi Inês
Great! I helped myself with some other samples from the internet in the meantime, but it is always better to have the "official" documentation at hand.

Thu, May 3, 9:46 AM · Game Physics, Documentation

Wed, May 2

Inês Almeida (brita_) closed T53838: Link to "demo_file.zip" in chapter "Vehicle Controller Physics" of the user manual is broken. as Resolved by committing rBM4243: Fix T53838: broken link in GameEngine VehicleController.
Wed, May 2, 11:36 PM · Game Physics, Documentation
Inês Almeida (brita_) reopened T53838: Link to "demo_file.zip" in chapter "Vehicle Controller Physics" of the user manual is broken. as "Open".

Hi @Friedemann Seebass (frisee)
I'm sorry I took this long replying, I have been more away from Blender than I wished to :)

Wed, May 2, 11:24 PM · Game Physics, Documentation
Aaron Carlisle (Blendify) added a comment to T54920: Documentation: Color Management - formula formatting misleading / wrong.

Thanks I will have a look later.

Wed, May 2, 2:47 PM · Documentation
Philipp Oeser (lichtwerk) added a comment to D3196: Fix Documentation: Color Management - formula formatting misleading / wrong (T54920).

I guess EXPOSURE_ADJUSTMENT is in stops, right?
So 2^{(stops)}

Wed, May 2, 1:47 PM · Documentation
Adam Kalisz (blender_ei) added a comment to T54920: Documentation: Color Management - formula formatting misleading / wrong.

Thx for spotting this.

Wed, May 2, 1:27 PM · Documentation
Adam Kalisz (blender_ei) created D3196: Fix Documentation: Color Management - formula formatting misleading / wrong (T54920).
Wed, May 2, 1:22 PM · Documentation
Philipp Oeser (lichtwerk) changed Type from Bug to To Do on T54920: Documentation: Color Management - formula formatting misleading / wrong.
Wed, May 2, 10:29 AM · Documentation
Philipp Oeser (lichtwerk) assigned T54920: Documentation: Color Management - formula formatting misleading / wrong to Aaron Carlisle (Blendify).

Thx for spotting this.
I'll change this to TODO and assign @Aaron Carlisle (Blendify) , but @Adam Kalisz (blender_ei) : could you submit a patch like described here?

Wed, May 2, 10:29 AM · Documentation
Adam Kalisz (blender_ei) added a comment to T54920: Documentation: Color Management - formula formatting misleading / wrong.

Thank you for your informative answer.

Wed, May 2, 6:02 AM · Documentation
Troy Sobotka (sobotka) added a comment to T54920: Documentation: Color Management - formula formatting misleading / wrong.

The correct formula for calculating scene referred exposure adjustments is:

Wed, May 2, 4:39 AM · Documentation

Tue, May 1

Adam Kalisz (blender_ei) created T54920: Documentation: Color Management - formula formatting misleading / wrong.
Tue, May 1, 10:03 PM · Documentation

Mon, Apr 30

Aaron Carlisle (Blendify) added a comment to T54879: Searching from 404 page leads to 404 page.

The issue is that Sphinx generates relative links, Im still trying to find a way to workaround this.

Mon, Apr 30, 3:42 PM · Documentation
Philipp Oeser (lichtwerk) assigned T54879: Searching from 404 page leads to 404 page to Aaron Carlisle (Blendify).

In fact, all of the links are broken from a 404 afaikt
@Aaron Carlisle (Blendify) : mind having a look?

Mon, Apr 30, 3:33 PM · Documentation
Kee Hoon Seong (Cyrus3DJ) added a watcher for Documentation: Kee Hoon Seong (Cyrus3DJ).
Mon, Apr 30, 7:23 AM

Sun, Apr 29

Aaron Carlisle (Blendify) added a member for Documentation: Eduardo Schilling (elschilling).
Sun, Apr 29, 7:58 PM

Sat, Apr 28

Ellwood Zwovic (gandalf3) created T54879: Searching from 404 page leads to 404 page.
Sat, Apr 28, 10:43 PM · Documentation

Fri, Apr 27

Eduardo Schilling (elschilling) added a watcher for Documentation: Eduardo Schilling (elschilling).
Fri, Apr 27, 6:08 AM

Wed, Apr 25

Aaron Carlisle (Blendify) added a member for Documentation: Leon (leonchen.prof).
Wed, Apr 25, 3:57 AM

Apr 23 2018

Leon (leonchen.prof) added a watcher for Documentation: Leon (leonchen.prof).
Apr 23 2018, 7:51 AM
Leon (leonchen.prof) removed a watcher for Documentation: Leon (leonchen.prof).
Apr 23 2018, 7:33 AM
Leon (leonchen.prof) added a watcher for Documentation: Leon (leonchen.prof).
Apr 23 2018, 7:33 AM

Apr 20 2018

blend-it (blend-it) updated the task description for T42765: IT translation.
Apr 20 2018, 9:35 AM · Documentation, Translations

Apr 16 2018

Aaron Carlisle (Blendify) abandoned D2711: PYAPI: Add more information to bge video texture docs.

Committed rBee2aa319821fdf8be869fc2800711d01b6350f41

Apr 16 2018, 7:36 PM · Game Engine, Python, Documentation, BF Blender
Aaron Carlisle (Blendify) abandoned D3123: Initial commit (Administrator audit) - bump.

I added you to the Documentation project so you can commit these changes if you want.
We currently don't review changes for translations (takes to much effort).

Apr 16 2018, 7:20 PM · Documentation
Aaron Carlisle (Blendify) updated the summary of D3149: Manual: Remove main bge python api docs.
Apr 16 2018, 2:24 PM · Python, Game Engine, BF Blender, Documentation