Skip to content

Commit 0bd7d5c

Browse files
committed
feat: add new resources and documentation for VSCode and GitLens
- Introduced a new journal entry for September 25, 2025, linking to a Reddit discussion about GitLens features. - Created documentation pages for GitLens and a guide on comparing files between branches in VSCode. - Added an image asset for visual reference in the comparison guide.
1 parent b675255 commit 0bd7d5c

File tree

5 files changed

+73
-1
lines changed

5 files changed

+73
-1
lines changed

assets/image_1758794025341_0.png

27.4 KB
Loading

journals/2025_09_25.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
## [[VSCode]]
2+
- [Anyone else missing Branches and Commits with in Source Control? : r/vscode](https://www.reddit.com/r/vscode/comments/1gu94qp/anyone_else_missing_branches_and_commits_with_in/)
3+
- > They can be enabled by clicking GitLens in the Source Control panel , clicking the three dots and selecting "Detach Branches View" (and other views as well).
4+
- [[VSCode/How To/Diff a file with another branch]]

pages/GitHub___aptrn___maxmsp-ts-example.md

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,4 +4,35 @@ created-by:: [[Person/Alessandro Petrone]]
44

55
- [aptrn/maxmsp-ts-example: Template Max Project with TypeScript and npm dependencies](https://github.com/aptrn/maxmsp-ts-example)
66
- > Template Max Project with TypeScript and npm dependencies
7-
-
7+
- ## [Bundle dependencies for Max](https://github.com/aptrn/maxmsp-ts-example?tab=readme-ov-file#bundle-dependencies-for-max)
8+
- You can install dependencies using `pnpm i -D <package-name>`. If you're sure the dependency is [**compatible with Max**](https://github.com/aptrn/maxmsp-ts-example?tab=readme-ov-file#dependencies), you can add it to the config file.
9+
10+
The configuration file `maxmsp.config.json` determines which dependencies are included in the compiled output. The default `output_path` is `lib`, placed as a subdirectory of the `outDir` found in the `tsconfig.json` file.
11+
12+
You can manually edit the `maxmsp.config.json` file or use command-line scripts:
13+
14+
```
15+
pnpm maxmsp add <package-name> [--alias] [--path] [--files]
16+
```
17+
- `--alias`: Optional. Sets the prefix for the copied files. Default is the package name.
18+
- `--path`: Optional. Sets the path to the package. Default is the package name.
19+
- `--files`: Optional. Sets the files to copy. Default is `index.js`.
20+
21+
Example:
22+
23+
```
24+
pnpm maxmsp add @not251/not251 --alias not251 --files "index.js, index.map.js"
25+
```
26+
27+
This will copy files:
28+
- `node_modules/@not251/not251/dist/index.js`
29+
- `node_modules/@not251/not251/dist/index.map.js`
30+
31+
To:
32+
- `lib/not251/not251_index.js`
33+
- `lib/not251/not251_index.map.js`
34+
35+
---
36+
37+
This project is heavily inspired by [TypeScript-for-Max](https://github.com/ErnstHot/TypeScript-for-Max) and uses [Max/Msp types at DefinitelyTyped](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/maxmsp)
38+
-
Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# [GitLens extension](https://marketplace.visualstudio.com/items?itemName=eamodio.gitlens)
2+
-
Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
tags:: [[Diataxis/How To]]
2+
3+
- # How To Compare a File with Another Branch in VS Code (GitLens)
4+
- ## Goal
5+
- View file differences between a file in your current branch and a file in another Git branch, similar to PyCharm’s *“Compare With Branch”* feature.
6+
- ## Preconditions
7+
- VS Code installed
8+
- Git repository initialized
9+
- [[VSCode/Extension/GitLens]] installed
10+
- ## Procedure
11+
- ### 1. Enable Branches View in GitLens for the [[VSCode/Panel/Source Control]] Source Code panel
12+
- Open **Source Control panel** (`Ctrl+Shift+G` / `Cmd+Shift+G`).
13+
- Expand the **GitLens** section.
14+
- Click the **three dots (…) menu**.
15+
- Select **Detach Branches View**.
16+
- This makes “Branches” appear as its own section.
17+
- See also: [Anyone else missing Branches and Commits with in Source Control? : r/vscode](https://www.reddit.com/r/vscode/comments/1gu94qp/anyone_else_missing_branches_and_commits_with_in/)
18+
- ### 2. Diff a Specific File with Another Branch
19+
- In the **Branches** view, locate your current branch
20+
- Click the disclosure triangle for `BRANCHNAME`
21+
- Click on the pencil icon in the entry `Compare BRANCHNAME`
22+
- Enter the branch name you wish to compare with
23+
- You should now see an entry underneath like `DDD files changed AAA additions (+), DDD deletions (-)`; click the disclosure triangle
24+
- Locate the specific file under the disclosure triangle you wish to compare, right click on it
25+
- Navigate to **Open Changes with → Open Changes with Working File**.
26+
- A side-by-side diff opens between your working copy and the file in the other branch.
27+
- ### 3. Diff All Files with Other Branch
28+
- Press on the `+/-` file button, which has the tooltip "Open All Changes as Working Tree"
29+
- ![image.png](../assets/image_1758794025341_0.png)
30+
- ## Gripes
31+
- There's no way to bring over individual lines from one side of the diff to the other, the way there is in [[PyCharm]] or [[JetBrains]]
32+
- ## Troubleshooting
33+
- If Branches aren’t showing, check the GitLens menu → **Detach Branches View**.
34+
- ## References
35+
- Use the command palette (`Ctrl+Shift+P`) → **GitLens: Compare with Branch** for a repo-wide compare.

0 commit comments

Comments
 (0)