fixed markdown

master
Ryan Schultz 1 year ago
parent 9833222b33
commit e89cdc4920
  1. 200
      BIM/Workflow/OD Workflows.md

@ -1,45 +1,27 @@
### Setting Up the Chat App
- We use [Element.io](https://element.io/) as our main chat app. Each OpeningDesign project has it'sr on
- example of past project
http://irst, then in Revit. Detect issues early
- Use simple extrusions as much as possible (Arch Wall/Structures/Panels or Part Extrude)
- Objects exported as IFC structural elements (beams, columns) often give problems in Revit. If needed, use BuildingElement Proxies (Will come as generic models, Revit won't apply any transformation own dedicated 'room'.
- We use [Element.io](https://element.io/) as our main chat app. Each OpeningDesign project has it's own dedicated 'room'.
them)
- Keep list of materials clean, merge duplicates, make sure all objects have a material
---
### Chat Channels
- Ins https://element.io/get-started
- examples of past projects
- http://openingdesign.com/communication/
- Majority of these rooms are public where past conversations can be reviewed by anyone, at anytime.
- There are private channels, however, as well.
- To install, go to https://element.io/get-started
- Element.io has apps for Web, Android, iOS, macOS, Windows & Linux
- Search and connect with ```@theoryshaw:matrix.org``` (Ryan Schultz)
### File Management on Windows
- If you use a file syncing software like dropbox, and plan to sync OpeningDesign files to multiple machines (tower, laptop, etc.) make sure the path where the files are synced is the same.
- Examples:
- Laptop: `D:\Dropbox\...`
- Tower: `D:\Dropbox\...`
### File Management on Windows
- download favorite text editor
- example: [Atom.io](https://atom.io/)
@ -48,87 +30,68 @@ them)
- ![](imgs/admin_atom.png)
- Install **Git** for Windows
- Download from [git-scm.com/download](https://git-scm.com/download)
- 'Run as adminitrator' as you did with the text editor above.
the installation file with [Administrator](https://www.youtube](https://t.com/wnd)
- Choose an appropriate installation location such as ```C:\Program FileC:\_tools\Ggit```
- Select Components: Install the default components, i che dft oponencluding Git GUI Here and Git Bash Here
- Choose default oolocation of 'start menu folder'. Will most likely default to the proper location.
- Choose an appropriate installation location such as ```C:\Program Files\Git```
- Select Components: Install the default components, including Git GUI Here and Git Bash Here
- Choose default location of 'start menu folder'. Will most likely default to the proper location.
- Choose your preferred Git default editor.
- For example, choose Atom.io, if that's your preferred text editor
- For example, choose Atom.io, if that's your preferred text editor
- Adjusting the name of the initial branch in new repositories.
- Let Git decide
tor.
- Choose recommended 'path environment'
- use openSSL library
- Accept the default line ending conversion for Unix and Windows compatibility
- use openSSL library
- Accept the default line ending conversion for Unix and Windows compatibility
- Checkout Windows-style, commit Unix-style line endings
- Use MinTTY
- Default (fast-forward or merge)
- Default (fast-forward or merge)
- Git Credential Manager Core
- Extra options
- Enable file system caching
- Enable GIT Credential Manager
- Extra options
- Enable file system caching
- Enable GIT Credential Manager
- Ignore experimental options
- Click Finish to complete the install.
- A few Windows configurations...
- Set longpath on windows
- Set longpath on windows
- Long answer: [here](https://www.youtube.com/watch?v=mAGQZ7RvKFk)
- Long answer [here](https://www.youtube.com/watch?v=mAGQZ7RvKFk)
- Short answer
- Go to start menu and type 'regedit'
-: Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
- Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
- Right click on `LongPathsEnabled` and then `Modify...`
Set LongPathsEnabled
- Value data: 1
- Value data: 1
- Run **Git Bash** in administrator mode, like [this](https://www.dropbox.com/s/wk3l5weh1pt70oh/3TOLBa3Rs0.mp4?dl=0) and do the following 3 commands. Do them in the exact following order.
- `git config --system core.longpaths true`
- Long answer [here](https://stackoverflow.com/questions/22575662/filename-too-long-in-git-for-windows/22575737#22575737)
- `git config --system --unset core.autocrlf`
- `git config --global core.autocrlf true`
- `git config --system --unset core.autocrlf`
- `git config --global core.autocrlf true`
- Create accounts at. t..
- Create accounts at...
- Gitlab: https://gitlab.com/users/sign_up
- Github: https:/is/github.com/join
- Github: https://github.com/join
- Downloadcerino and install https://toertoisegit.org/download/
- Download and install https://tortoisegit.org/download/
- TortoiseGitPlink based on PuTTY...
- Custom setup:
- choose defaults
- Run fFirst start wizard
- Language
- Run first start wizard
- Language
- Welcome screen
- next
- Point to git.exe (will probably default to the proper location)
- Configure user information
- Configure user information
- add name and email *(preferably use the same email you used to with your Gitlab or Github accounts)*
- Authentication- the and credential store
- Authentication and credential store
- choose defaults
- Follow the steps at the following link to create your private/public GPG keys
- [Windows - Creating New GPG Keys with Kleopatra](https://github.com/OpeningDesign/encryption-test/blob/master/README.md#windows---creating-new-gpg-keys-with-kleopatra)
@ -140,58 +103,16 @@ Set LongPathsEnabled
#
<br>
---
<br>
### Markdown Editor
- We use markdown a lot. [Here's](https://yorik.uncreated.net/blog/2021-015-markdown) why.
- Some of our favorite open source desktop markdown editors
- [Marktext](https://marktext.app/)
- Some of our favorite open source web-based markdown editors
- Authentication and reetial store
- choose defaults
- eat ntl [](s/.pgwingdoladl i adnito](s/oe.n) igee default components
- Create accounts at...
- [StackEdit](https://stackedit.io/app#)
---
### Cloning a Repo for the First Time
*Essentionally ''cloning' a repo means you're downloading the entire project folder onto your local machine. Once it pulled down (downloaded) you don't have to clone it again.*
*After it's cloned, if there's a change on the repo you want to pull down to your local machine, follow the steps in the following section: [Pulling the latest changes down from the remote repo](#pulling-the-latest-changes-down-from-the-remote-repo)*.
*After it's cloned, if there's a change on the repo you want to pull down to your local machine, follow the steps in the following section: [Pulling the latest changes down from the remote repo](#pPulling- the- latest- changes- down- from- the- remote- repo)*.
Github: https://github.m/n
ia hgitlgn_up
---
### Cloning a Repo for the First Time
1. Copy the HTTPS address from either Github or Gitlab.
- From Gitlab...
- ![](imgs/Gitlab_https.png)
@ -201,56 +122,38 @@ Github: https://github.m/n
- ![](imgs/clone_1.png)
- The following fields should already be filed in and then hit 'okay'![](imgs/clone_2.png)
<br>
---
<br>
---
### Pulling the latest changes down from the remote repo
1. Right click anywhere in the local folder and go to 'Git Sync'..
- ![](imgs/sync_1.png)
- And then 'Pull' ![](imgs/sync_2.png)
<br>
---
<br>
---
### Pushing a change
* right click anywhere in window to bring up the following context menu. go to ***Git Commit -> "master"...***![](imgs/Git_commit.png)
* Fill in the following below, and hit 'Commit & Push'![](imgs/commit_dialong.png)
<br>
---
<br>
### Starting a Project
- Create a [blank project](https://gitlab.com/projects/new#blank_project) on Gitlab
- [Clone the repo](#cloning-a-repo-for-the-first-time)
- Copy in all the template folders located here: ```OD_Library\Project Folder Structure``` and [push](#pushing-a-change).
@ -259,19 +162,14 @@ Github: https://github.m/n
- Tell collaborators to subscribe to Gitlab notifications.
- [one way](imgs/gitlab_notifications.png)
<br>
---
<br>
### Revit Specific
- Try not to use the following, if possible...
1. Dumb text notes. Prioritize the following instead.
- 1st priority: Material Tags
@ -283,61 +181,44 @@ Github: https://github.m/n
- use Visibility/Graphic Overrides for Categories instead, or better yet, use View Templates
4. Paint a material on an object. (apply a material via a type, or to entire object)
<br>
---
<br>
### FreeCAD Specific
- Export IFC files very soon and very often, test them in [IFC++](https://ifcquery.com/) first, then in Revit. Detect issues early
- Use simple extrusions as much as possible (Arch Wall/Structures/Panels or Part Extrude)
- Objects exported as IFC structural elements (beams, columns) often give problems in Revit. If needed, use BuildingElement Proxies (Will come as generic models, Revit won't apply any transformation on them)
- Keep list of materials clean, merge duplicates, make sure all objects have a material
<br>
---
<br>
### Creating a New Revit Family
1. When creating a new revit family, one of the cardinal rules when making families is that the objects should be constained to reference planes.
2. There might be exceptions, but another cardinal rule is to start with a family template of the thing you're modeling... that is, use a window template for windows, door template for doors, etc.
<br>
---
<br>
---
### File too large to push to Github
If your file ever gets above 100mbs and you can't push to Github, try...
1. Purge all. Run this (3) times to fully purge everything.
![](imgs/PurgeAll.png)
2. For whatever reason, if you do a 'save as' to a temporary file name, and do another 'save as' to overwrite the original file. it reduces the file size.
<br>
---
@ -358,81 +239,60 @@ If your file ever gets above 100mbs and you can't push to Github, try...
---
<br>
### Random
- connecting stackedit to gitlab: https://dev.to/maxwhite20062003/how-to-link-your-gitlab-account-to-stackedit-2pkc
---
### Random Errors
- If warnings..
- warning: LF will be replaced by CRLF.
- Solution
1. `git config --system --unset core.autocrlf`
2. `git config --global core.autocrlf true`
- clean filter git crypt failed
- https://github.com/AGWA/git-crypt/issues/184#issuecomment-541942913
C:\Users\ryan\.gnupg
- Git bash Error: Could not fork child process:
- https://stackoverflow.com/questions/45799650/git-bash-error-could-not-fork-child-process-there-are-no-available-terminals/
- kill the 'agent' process that you last used.
- might be: gpg-agent.exe
- To reset harder!
- https://stackoverflow.com/a/4327720
- Buffer error
- RPC failed; HTTP 524 curl 22 The requested URL returned error: 524 fatal: the remote end hung up unexpectedly: https://confluence.atlassian.com/bitbucketserverkb/git-push-fails-fatal-the-remote-end-hung-up-unexpectedly-779171796.html
- `git config --global http.postBuffer 157286400`
- [rm -f .git/index.lock](https://stackoverflow.com/questions/9282632/git-index-lock-file-exists-when-i-try-to-commit-but-cannot-delete-the-file/11466435#11466435)
- assume-unchanged and skip-worktree flags
- https://fallengamer.livejournal.com/93321.html
- Usually:
- Record audio and mic on ShareX: https://softwarerecs.stackexchange.com/questions/42767/screen-recording-tool-that-records-both-speaker-o-p-as-well-as-mic-input/74728#74728
- ```-f dshow -i audio="virtual-audio-capturer" -filter_complex amix=inputs=2:duration=longest```
- Keycast: https://github.com/bfritscher/carnac/releases
- Github personal access tokens
- https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
%t%pn%y-%mo-%d_%h-%mi-%s_%pn
<!--stackedit_data:
eyJoaXN0b3J5IjpbMTEwMDM2MjU5MSwtOTM0OTE1NTM3LC03Nj
IwNTM1OTYsNzA2MjYzOTUxLC0xNTI5NzU2MjQxLDE3NzgxMzQx
NCw5NjMxMzQ1ODEsOTg4OTcyNjMzLC0yMDA0NTE4MjkzLC0yMD
A0NTE4MjkzLC02Mjk1MTI4MTddfQ==
-->
eyJoaXN0b3J5IjpbNzA2MjYzOTUxLC0xNTI5NzU2MjQxLDE3Nz
gxMzQxNCw5NjMxMzQ1ODEsOTg4OTcyNjMzLC0yMDA0NTE4Mjkz
LC0yMDA0NTE4MjkzLC02Mjk1MTI4MTddfQ==
-->

Loading…
Cancel
Save