Docs: Project Tools Update #156

Merged
Nick Alberelli merged 59 commits from :docs/project-tools-update into main 2023-10-19 22:21:50 +02:00
Showing only changes of commit 5120390f96 - Show all commits

View File

@ -1,38 +1,47 @@
# Running Blender # Running Blender
## Launch Blender from Taskbar/Start Menu ## Create Blender Shortcut
Once your project has been setup using the "Project Tools" scripts Blender should be available inside your application's native application launcher. The run Blender script will take the correct blender version for your operating system from `{my_project}/shared/artifacts/blender` and extract it to the local directory. Along with any add-ons in the `{my_project}/shared/artifacts/addons` folder. Your Blender preferences are stored on a per project basis in `{directory-path}`
### Create Linux Shortcut
<!--- <!---
TODO Add INFO box to direct users to TD Guide to set this up for your specific OS TODO Add INFO box to direct users to TD Guide to set this up for your specific OS
---> --->
::: info Available on Gentoo ```bash
To learn more about running the Blender if you are on a Gentoo system please see the [Gentoo guide](/gentoo/user/running-blender.md), including how to run a [debug build](/gentoo/user/running-blender.md#debug-build). cd {my_project}/svn/tools
::: ./install_desktop_file.sh
```
Once your project has been setup using the "Project Tools" scripts Blender should be available inside your application's native application launcher. The run Blender script will take the correct blender version for your operating system from `{my_project}/shared/artifacts/blender` and extract it to the local directory. Along with any add-ons in the `{my_project}/shared/artifacts/addons` folder. Your Blender preferences are stored on a per project basis in `{directory-path}`
<!--- <!---
TODO TODO
Ask sebastian for this path and if it's different per os Ask sebastian for this path and if it's different per os
---> --->
<!---
TODO
- Add this to TD Guide too
-Verify Python Version
--->
::: info Python Requirement
Running this script requires python 2.7+, please ensure python is installed on your system before running blender with the below instructions
:::
1. Search for Blender in your Application Launcher 1. Search for Blender in your Application Launcher
2. The application with the name `blender {my_project}` without any suffix is the latest build. 2. The application with the name `blender {my_project}` without any suffix is the latest build.
::: info Available on Gentoo
To learn more about running the Blender if you are on a Gentoo system please see the [Gentoo guide](/gentoo/user/running-blender.md), including how to run a [debug build](/gentoo/user/running-blender.md#debug-build).
:::
<!--- <!---
TODO Replace Image with Project-Tools version TODO Replace Image with Project-Tools version
--->
![Image of Blender Icon in KDE Taskbar/Start Menu](/media/user-guide/launch_blender.mp4) ![Image of Blender Icon in KDE Taskbar/Start Menu](/media/user-guide/launch_blender.mp4)
--->
### Create Windows Shortcut
1. Open the directory `{my_project}/svn/tools`
2. Create a shortcut to `launch_blender_win.bat` on your desktop
### Create Mac Shortcut
1. Open the directory `{my_project}/svn/tools`
2. In finder, select the `launch_blender_mac.command` and press `ctrl+shift+command+t` to add it to the dock.
## Launch Blender from Terminal ## Launch Blender from Terminal