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

Mon, Sep 17

Brecht Van Lommel (brecht) added a member for Documentation: Jacques Lucke (JacquesLucke).
Mon, Sep 17, 10:32 AM

Fri, Aug 31

Aaron Carlisle (Blendify) closed T54104: Softbody: dublication as Resolved.

Fixed in rBM4430

Fri, Aug 31, 4:00 AM · Documentation

Fri, Aug 24

Yevgeny Makarov (jenkm) closed T52949: RGB-value difference in UI as Resolved.
Fri, Aug 24, 3:14 PM · Documentation
Yevgeny Makarov (jenkm) added a commit to T52949: RGB-value difference in UI: rBM4426: some fixes for vertex color.
Fri, Aug 24, 3:14 PM · Documentation

Thu, Aug 23

Yevgeny Makarov (jenkm) closed T52270: Add docs talking about the difference between disk and external caches as Resolved.
Thu, Aug 23, 1:05 PM · Documentation
Yevgeny Makarov (jenkm) closed T54277: Particle Instance Modifier stops Particle Info Node having in information as Resolved.
Thu, Aug 23, 12:53 PM · Documentation
FeRD (Frank Dana) (ferdnyc) added a comment to D3614: Enhance Cycles docs on building CUDA kernel.

Note that for Cycles it's quite safe to remove this test, as we don't compile any host code with nvcc and so version incompatibilities with GCC are not a problem.

Thu, Aug 23, 1:30 AM · Documentation
Brecht Van Lommel (brecht) closed D3614: Enhance Cycles docs on building CUDA kernel.
Thu, Aug 23, 12:42 AM · Documentation
Brecht Van Lommel (brecht) accepted D3614: Enhance Cycles docs on building CUDA kernel.

I'll commit this with some tweaks.

Thu, Aug 23, 12:41 AM · Documentation

Wed, Aug 22

Inês Almeida (brita_) added a reviewer for D3614: Enhance Cycles docs on building CUDA kernel: Cycles.
Wed, Aug 22, 10:11 PM · Documentation
Inês Almeida (brita_) added reviewers for D3614: Enhance Cycles docs on building CUDA kernel: Sergey Sharybin (sergey), Brecht Van Lommel (brecht).
Wed, Aug 22, 10:10 PM · Documentation

Aug 17 2018

Tobias Heinke (TobiasH) added a comment to T56420: Version Switch is not basing the lang links off the current version in url.

the JS works as intended, it's the JSON:
the version is extracted from the second column, because the theme var is a number (and not 'latest').
so there can't be '2.79' two times - it will take the first match.

Aug 17 2018, 12:25 AM · Documentation

Aug 16 2018

Aaron Carlisle (Blendify) triaged T56420: Version Switch is not basing the lang links off the current version in url as High priority.
Aug 16 2018, 7:28 PM · Documentation
Aaron Carlisle (Blendify) updated the task description for T50464: Move content from wiki to manual.
Aug 16 2018, 4:06 AM · Documentation
Aaron Carlisle (Blendify) moved T50464: Move content from wiki to manual from Administrative to Rewrite documentation on the Documentation board.
Aug 16 2018, 4:06 AM · Documentation
Aaron Carlisle (Blendify) moved T48381: Move old release logs to the wiki from Administrative to Rewrite documentation on the Documentation board.
Aug 16 2018, 4:05 AM · Documentation
Aaron Carlisle (Blendify) added subtasks for T56179: 2.8 Documentation Stage 1 prep work: T56215: Remove Links to old blender wiki, T56342: FIle downloads: re-evaluate .
Aug 16 2018, 3:59 AM · Documentation
Aaron Carlisle (Blendify) added a parent task for T56215: Remove Links to old blender wiki: T56179: 2.8 Documentation Stage 1 prep work.
Aug 16 2018, 3:59 AM · Documentation
Aaron Carlisle (Blendify) added a parent task for T56342: FIle downloads: re-evaluate : T56179: 2.8 Documentation Stage 1 prep work.
Aug 16 2018, 3:59 AM · Documentation
Aaron Carlisle (Blendify) updated the task description for T56179: 2.8 Documentation Stage 1 prep work.
Aug 16 2018, 3:59 AM · Documentation

Aug 15 2018

FeRD (Frank Dana) (ferdnyc) updated the diff for D3614: Enhance Cycles docs on building CUDA kernel.

Reuploading against Blender Manual repository.

Aug 15 2018, 11:08 PM · Documentation
FeRD (Frank Dana) (ferdnyc) added a comment to D3614: Enhance Cycles docs on building CUDA kernel.

This is my first Phabricator submission and I may have mis-filed this diff, apologies if so.

Aug 15 2018, 11:02 PM · Documentation
FeRD (Frank Dana) (ferdnyc) created D3614: Enhance Cycles docs on building CUDA kernel.
Aug 15 2018, 10:50 PM · Documentation

Aug 14 2018

Aaron Carlisle (Blendify) updated the task description for T55018: Documentation for 2.8 (WIP).
Aug 14 2018, 10:09 PM · Code Quest, BF Blender: 2.8, Documentation
Aaron Carlisle (Blendify) added a comment to T56342: FIle downloads: re-evaluate .

I would like if we keep downloads and write some rules:

Aug 14 2018, 10:07 PM · Documentation
Aaron Carlisle (Blendify) added a comment to T49262: Manual Versioning.

@Tobias Heinke (TobiasH) are you available to help with the java scripting again? We are ready to work on this. I tried to finish it but its not working.

Aug 14 2018, 9:35 PM · Infrastructure: Websites, Documentation
Aaron Carlisle (Blendify) updated the task description for T49262: Manual Versioning.
Aug 14 2018, 9:34 PM · Infrastructure: Websites, Documentation
Aaron Carlisle (Blendify) updated the task description for T55018: Documentation for 2.8 (WIP).
Aug 14 2018, 9:31 PM · Code Quest, BF Blender: 2.8, Documentation
Dan McGrath (dmcgrath) added a comment to T56370: Manual stopped updating from svn.

Ah, there was also a left over cruft temporary lock file (I use them to prevent multiple runs of builds) that was left around blocking engilsh. It should be up to date now.

Aug 14 2018, 9:02 PM · Infrastructure: Websites, Documentation
Dan McGrath (dmcgrath) added a comment to T56370: Manual stopped updating from svn.

Oh, I forgot to rsync the base manual actually! I only did the languages. Check again in about 5 minutes, it's running now.

Aug 14 2018, 8:54 PM · Infrastructure: Websites, Documentation
Aaron Carlisle (Blendify) added a comment to T56370: Manual stopped updating from svn.

@Dan McGrath (dmcgrath) https://svn.blender.org/svnroot/bf-manual/trunk/blender_docs/resources/versions.json does not match https://docs.blender.org/manual/en/dev/versions.json this was committed a while ago. (rBM4397)

Aug 14 2018, 8:51 PM · Infrastructure: Websites, Documentation
Dan McGrath (dmcgrath) closed T56370: Manual stopped updating from svn as Resolved.

Seems that on or around the 11th I did some port maintenance and stopped cron so that the manual wouldn't try running while I was working. Unfortunately I also forgot to restart it. As well, there were actually other issues WRT the new IP being used that would have blocked things. I think it should be all working now though.

Aug 14 2018, 8:03 PM · Infrastructure: Websites, Documentation
Aaron Carlisle (Blendify) placed T56370: Manual stopped updating from svn up for grabs.

@Dan McGrath (dmcgrath) any reason for this? I heard there was some server issues recently? If this is not on your end can you paste any error logs?

Aug 14 2018, 2:00 PM · Infrastructure: Websites, Documentation
Bastien Montagne (mont29) assigned T56370: Manual stopped updating from svn to Campbell Barton (campbellbarton).
Aug 14 2018, 9:45 AM · Infrastructure: Websites, Documentation
Yevgeny Makarov (jenkm) created T56370: Manual stopped updating from svn.
Aug 14 2018, 8:25 AM · Infrastructure: Websites, Documentation

Aug 13 2018

Yevgeny Makarov (jenkm) added a comment to T56324: Mirror Modifier wrong UV Offsets.

I just read the tooltip as "move the flipping point and then flip over it",
but here it first flips and then moves, i.e. it's just a offset.

Aug 13 2018, 2:29 PM · Documentation, BF Blender
Brecht Van Lommel (brecht) moved T55018: Documentation for 2.8 (WIP) from Short Term Backlog to Release Targets on the Code Quest board.
Aug 13 2018, 11:42 AM · Code Quest, BF Blender: 2.8, Documentation
Bastien Montagne (mont29) triaged T56342: FIle downloads: re-evaluate as Normal priority.
Aug 13 2018, 11:31 AM · Documentation
Bastien Montagne (mont29) closed T56324: Mirror Modifier wrong UV Offsets as Invalid.

Things are working as expected, 0.25 means flipping point is at 0.75, which is the case (taking into account things are mirrored, line between D2 and D3 columns is at 0.75 of the mirrored face). Agree those two settings (flip offset, and offset) end up doing the same thing, but there is no bug here.

Aug 13 2018, 11:26 AM · Documentation, BF Blender
Yevgeny Makarov (jenkm) renamed T56324: Mirror Modifier wrong UV Offsets from Mirror Modifier two UV Offsets options to Mirror Modifier wrong UV Offsets.
Aug 13 2018, 8:28 AM · Documentation, BF Blender
Yevgeny Makarov (jenkm) added a comment to T56342: FIle downloads: re-evaluate .

Some remarks:

Aug 13 2018, 8:08 AM · Documentation
Aaron Carlisle (Blendify) created T56342: FIle downloads: re-evaluate .
Aug 13 2018, 4:09 AM · Documentation

Aug 12 2018

Aaron Carlisle (Blendify) closed D3582: Fix some grammar and errors in VSE introduction.
Aug 12 2018, 7:39 PM · Documentation
Yevgeny Makarov (jenkm) added a comment to T56324: Mirror Modifier wrong UV Offsets.

OK, "Flip U/V Offset" should shift the flipping point from the 0.5 (as tooltips says).

Aug 12 2018, 1:57 PM · Documentation, BF Blender
Bastien Montagne (mont29) closed T56324: Mirror Modifier wrong UV Offsets as Invalid.

Please use this bug tracker for reporting bugs. General discussion and inquiries like that shall go through IRC (#blendercoders on freenode.net) or ML (bf-committers@blender.org).

Aug 12 2018, 12:59 PM · Documentation, BF Blender

Aug 11 2018

Yevgeny Makarov (jenkm) assigned T56324: Mirror Modifier wrong UV Offsets to Campbell Barton (campbellbarton).
Aug 11 2018, 9:10 PM · Documentation, BF Blender
Yevgeny Makarov (jenkm) created T56324: Mirror Modifier wrong UV Offsets.
Aug 11 2018, 9:08 PM · Documentation, BF Blender
Aaron Carlisle (Blendify) accepted D3582: Fix some grammar and errors in VSE introduction.

Looks good one comment.

Aug 11 2018, 7:46 PM · Documentation
Aaron Carlisle (Blendify) accepted D3582: Fix some grammar and errors in VSE introduction.
Aug 11 2018, 7:46 PM · Documentation

Aug 9 2018

Aaron Carlisle (Blendify) updated the task description for T56215: Remove Links to old blender wiki.
Aug 9 2018, 5:07 PM · Documentation