Noted: Sunday, October 20, 2024, 14:00:00 + 5

main
Shwetha Jayaraj 2024-10-20 14:00:00 -04:00
parent 92e7ff79d3
commit 3072765edc
4 changed files with 171 additions and 23 deletions

View File

@ -1,5 +1,17 @@
{
"recentFiles": [
{
"basename": "Notable Obsidians",
"path": "About Obsidian/Obsidian Guides/Notable Obsidians.md"
},
{
"basename": "Contributing to an Obsidian",
"path": "About Obsidian/Obsidian Guides/Contributing to an Obsidian.md"
},
{
"basename": "Formulas in Obsidian Advanced Tables",
"path": "About Obsidian/Obsidian Guides/Formulas in Obsidian Advanced Tables.md"
},
{
"basename": "Developing Quantum Computing & Teaching Quantum Information Science Education",
"path": "Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Developing Quantum Computing & Teaching Quantum Information Science Education.md"
@ -20,10 +32,6 @@
"basename": "About Notepad",
"path": "About Notepad.md"
},
{
"basename": "Formulas in Obsidian Advanced Tables",
"path": "About Obsidian/Obsidian Guides/Formulas in Obsidian Advanced Tables.md"
},
{
"basename": "Netlify & Vercel",
"path": "Coding Tips (Classical)/Terminal Tips/3. GUIs/Internet/Websites/Hosting/Netlify & Vercel.md"
@ -176,10 +184,6 @@
"basename": "Pasted image 20241019192651",
"path": "About Obsidian/imgFiles/Pasted image 20241019192651.png"
},
{
"basename": "Notable Obsidians",
"path": "About Obsidian/Obsidian Guides/Notable Obsidians.md"
},
{
"basename": "Quantum Education Workshop",
"path": "Machine Tips (Quantum)/Resources/Companies, Orgs, & Events/Quantum World Congress & RQS/Quantum Education Workshop.md"
@ -195,10 +199,6 @@
{
"basename": "Knowledge base & info resources;",
"path": "Machine Tips (Quantum)/Resources/Companies, Orgs, & Events/Qubit by Qubit Course Development/Knowledge base & info resources;.md"
},
{
"basename": "Machine Learning (QML)",
"path": "Machine Tips (Quantum)/Resources/Technologies, Orgs, & Apps/Applications/Machine Learning/Machine Learning (QML).md"
}
],
"omittedPaths": [],

View File

@ -25,14 +25,26 @@
"state": {
"type": "markdown",
"state": {
"file": "Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Developing Quantum Computing & Teaching Quantum Information Science Education.md",
"file": "About Obsidian/Obsidian Guides/Notable Obsidians.md",
"mode": "source",
"source": false
}
}
},
{
"id": "50515ec1f147211e",
"type": "leaf",
"state": {
"type": "markdown",
"state": {
"file": "About Obsidian/Obsidian Guides/Notable Obsidians.md",
"mode": "source",
"source": false
}
}
}
],
"currentTab": 1
"currentTab": 2
}
],
"direction": "vertical"
@ -115,7 +127,7 @@
"state": {
"type": "backlink",
"state": {
"file": "Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Developing Quantum Computing & Teaching Quantum Information Science Education.md",
"file": "About Obsidian/Obsidian Guides/Notable Obsidians.md",
"collapseAll": false,
"extraContext": false,
"sortOrder": "alphabetical",
@ -132,7 +144,7 @@
"state": {
"type": "outgoing-link",
"state": {
"file": "Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Developing Quantum Computing & Teaching Quantum Information Science Education.md",
"file": "About Obsidian/Obsidian Guides/Notable Obsidians.md",
"linksCollapsed": false,
"unlinkedCollapsed": true
}
@ -155,7 +167,7 @@
"state": {
"type": "outline",
"state": {
"file": "Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Developing Quantum Computing & Teaching Quantum Information Science Education.md"
"file": "About Obsidian/Obsidian Guides/Notable Obsidians.md"
}
}
}
@ -183,15 +195,17 @@
"obsidian-excalidraw-plugin:Create new drawing": false
}
},
"active": "c20bcf4612e341c6",
"active": "50515ec1f147211e",
"lastOpenFiles": [
"About Obsidian/Obsidian Guides/Contributing to an Obsidian.md",
"About Obsidian/Obsidian Guides/Notable Obsidians.md",
"About Obsidian/Obsidian Guides/Formulas in Obsidian Advanced Tables.md",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Developing Quantum Computing & Teaching Quantum Information Science Education.md",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Landing Page.md",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Wish List for website.md",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Shwetha Jayaraj Notes.md",
"About Notepad.md",
"About Obsidian/Obsidian Guides/Formulas in Obsidian Advanced Tables.md",
"Coding Tips (Classical)/Terminal Tips/3. GUIs/Internet/Websites/Hosting/Netlify & Vercel.md",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website/Developing Quantum Computing & Teaching Quantum Information Science Education.md",
"Machine Tips (Quantum)/Quantum spaces.canvas",
"Machine Tips (Quantum)/Resources/Technologies, Orgs, & Apps/Applications/A-Z Applications.md",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Jetzy/Selfie_Verify/Jetzy verification app.md",
@ -210,8 +224,6 @@
"Coding Tips (Classical)/Terminal Tips/3. GUIs/Internet/Websites/Hosting/TLD.md",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/My Domain Names.md",
"About Obsidian/Alt. Obsidian.md",
"Machine Tips (Quantum)/Project Vault/Constructions/3D printing/Cura.md",
"Machine Tips (Quantum)/Project Vault/Constructions/Making Machines.md",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Personal Website/Recording 20231210205353.webm",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Content for website",
"Coding Tips (Classical)/Project Vault/Current Projects/Programming projects/Website Projects/Personal Website/Recording-20231210205423.webm",

View File

@ -0,0 +1,133 @@
The process for this is similar to the process for forking a github and pushing changes to a repository. It is really nicely outlined here though by another Obsidian user in his [modding](https://morrowind-modding.github.io/contributing/how-to-contribute) wiki.
In order to contribute to the wiki, you must have three things:
1. A [GitHub](https://github.com/) account
2. The [Obsidian](https://obsidian.md/) app
3. [Git](https://git-scm.com/downloads)
*nix users, feel free to grab the above applications from your local package manager instead.
We assume for the sake of this document that you already all three of these. We have done what we can to minimize interaction with Git and we will walk you through necessary steps to use it. We also hope that you will very much enjoy using Obsidian.
# Fork the Repository[](https://morrowind-modding.github.io/contributing/how-to-contribute#fork-the-repository)
1. Go to the [wiki repository](https://github.com/morrowind-modding/wiki)
2. Click `Fork`, then `Create Fork`:
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/mmw-github-with-fork-button-highlighted.png)
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/creating-a-github-fork-of-mmw.png)
Now you have your own unique copy of the entire repository which you can change however you like and even rehost. Note that over time the repository may grow to be fairly large.
NOTE: Developers may build the site locally with the following `npm` command:
`npm i`
`npx quartz build --serve`
You will be brought to your newly created copy of the wikis github. Get your repos url by clicking `Code`, then `HTTPS`, then the clipboard icon.
Stash the URL somewhere safe, as you will need it later. Or, if you simply want a copy of the wiki for your personal Obsidian vault - youre done! ![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/copying-url-of-mmw-github-fork.png)
# Get A Personal Access Token[](https://morrowind-modding.github.io/contributing/how-to-contribute#get-a-personal-access-token)
In order to make changes to the wikis GitHub through Obsidian, you must give it a special key that says it has permission from you to do so first.
1. Log into your Github account and open your profile. Then go to Settings. You can open your profile from any part of the GitHub site by clicking your profile picture in the upper right corner of the page:
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/locating-user-settings-in-github.png)
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/github-user-with-settings-highlighted.png)
2. Go to `developer settings`, then `Personal Access Tokens`, and select `Token (Classic)`:
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/selecting-developer-settings-in-github-settings.png)
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/tokens-classic-in-github-developer-settings.png)
On this final menu, select `Generate a Personal Access Token`:
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/github-personal-access-tokens-screen.png)
3. On this page you name your key and set its expiration date. We recommend doing a `Custom` expiration for one year from the date you are creating the key. This is as long as GitHub will allow them to live. Then, make sure to click the checkbox next to `repo`. Finally, click `Generate Token` at the bottom of the page. Please take special note of the fact that you will not be able to see your personal access token again after creating it - leave the page open until youve configured Obsidian!
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/selecting-github-personal-access-token-scope.png)
# Set Up Obsidian[](https://morrowind-modding.github.io/contributing/how-to-contribute#set-up-obsidian)
## Install Git for Obsidian[](https://morrowind-modding.github.io/contributing/how-to-contribute#install-git-for-obsidian)
Now you just need to hook your personal access token and repository fork into Obsidian itself.
1. Open Obsidian and click the settings gear in the bottom-left.
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/selecting-settings-in-obsidian.png)
2. Go to `Community Plugins`, then `Browse`. Search for `Git`.
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/community-plugins-settings-in-obsidian.png)
Select the first result, hit `Install`, then `Enable`.
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/locating-git-plugin-in-obsidian.png)
## Clone the Repository[](https://morrowind-modding.github.io/contributing/how-to-contribute#clone-the-repository)
1. Open the Command Palette by pressing `CTRL+P`
2. Type in clone, and select `Clone an existing repo`
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/cloning-a-repo-with-obsidian-git.png)
3. Paste in your repository URL in the following format:
`https://<PERSONAL_ACCESS_TOKEN>@github.com/<USERNAME>/<REPO>.git`
Replace `<PERSONAL_ACCESS_TOKEN>` with your previously generated key, and your username in place of `<USERNAME>`: ![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/obsidian-git-clone-personal-access-token.png)
Pick a name for the folder, and leave the second box about `Clone depth` blank - simply press enter. Now the wiki is installed inside of obsidian, and you can make edits to your local copy of it. Lets start by sending over this very document!
## Editing Guide[](https://morrowind-modding.github.io/contributing/how-to-contribute#editing-guide)
Pick where your document should go first. Most contributor content should go under `Guides`, but if youre making edits to a specific project, then use that folder instead. Feel free to create new folders if you feel your document necessitates it.
### REQUIREMENTS:[](https://morrowind-modding.github.io/contributing/how-to-contribute#requirements)
- Due to compatibility issues with Obsidian and Quartz, only some file types can be accepted. Videos must be in webm format before publication. Any audio which is not directly relevant to the subject of the video clip must be removed as well to limit file sizes. Maintainers can help you with this. You can use something like [Simple Screen Recorder](https://github.com/lextrack/Simple-Screen-Recorder)or [OBS](https://obsproject.com/) to record your screen with or without audio.
- Morrowind-specific file types such as `nif`, `dds`, and `esm` will not directly be recognized by Obsidian and cant be opened as notes. They will, however, appear in your source control view and can be added to links in your documents.
- For example, if your asset is a texture in: `Assets/Animation/Simple Texture Animation in Blender`, then you make a link to it in your document like this:
> [sky5_blu.dds](https://morrowind-modding.github.io/Assets/Animation/Simple-Texture-Animation-in-Blender/sky5_blu.dds)
- Submissions should be tagged with the tools used and subject covered. See existing guides for exmples. To add a tag, simply use an octothorpe `#` and the name of the tag.[blender](https://morrowind-modding.github.io/tags/blender) or[CSSE](https://morrowind-modding.github.io/tags/CSSE) are existing tags which you may use, but feel free to make up any that are relevant.
### Basic Folder Structure[](https://morrowind-modding.github.io/contributing/how-to-contribute#basic-folder-structure)
- Guides Umbrella Heading
- Concept a landing page summarizing the concept e.g., Textures
- Sub-Concepts elaborating on specific parts of a concept e.g., AI Upscaling
- Tutorials e.g., Upscaling a texture with Gigapixel AI
- Programs and Tools Umbrella Heading
- (Tool Type) landing page for categories of tools e.g., 3D Modelling
- (Program Name) e.g., Blender
- Projects Umbrella Heading
- (Project Name) *Summary page about the project
- (Structure from here could vary depending on the project)
- Contributing to Morrowind Modmaking Wiki
Text documents should be placed at the authors discretion, with any assets (ESM, DDS, pictures, videos, etc) placed inside of a corresponding folder under `Assets`. See the Morrowind Interiors Project guide for an example:
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/screenshot-of-mmw-obsidian-assets-folder.png)
You can drag any files your document depends on right into Obsidian and place them into this folder. This helps keep the wiki easy to navigate.
## Send It Home[](https://morrowind-modding.github.io/contributing/how-to-contribute#send-it-home)
Once youre done editing:
1. Make sure the right sidebar is open
2. Select the source control view (if its not visible you may need to drag the sidebar a bit further out)
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/obsidian-git-source-control.png)
Your changes will be listed here - click the back arrow to revert them, or the plus sign to `Stage` them. This simply means you are preparing to send them to github. Take this opportunity make sure you recognize everything you added or changed before staging your changes. Mistakes can be made!
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/closeup-of-obsidian-git-source-control.png)
This is where your commit message will be written. This is simply meant to be an informative note regarding the changes you made. Once thats done, click the buttons above in the listed order. Do not click button `1` if you manually staged individual files as described above.
Youre all done editing! The only thing left for you the creator to do is submit it for review. Go back to your fork on GitHub. You should see a message similar to the one below; click `Contribute`, then `Open Pull Request`.
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/opening-github-pr-from-fork.png)
A summary of your changes will appear. If you already know whats been done, then keep it simple - Just press open pull request. ![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/creating-a-pr-in-github.png)
We promise, this is the last page. This is your opportunity to explain your changes, what they do, and why they exist. Dont be afraid to say whatever you feel is appropriate - be elaborate, be concise, but please explain what you did somehow or another. if you wish, check `Allow edits by maintainers`, to allow the core team to make changes to your Pull Request whilst its being reviewed.
![](https://morrowind-modding.github.io/assets/contributing/how-to-contribute/adding-description-to-github-pr.png)
Reviews may be quick or not, but, please do what you are able to communicate with the team regarding any questions or issues that may come up during review. Pull Requests that are abandoned after 30 days will be assumed to be left in the entirely hands of the team and will be handled according to their judgment.
If all goes well, you are now done with the entire process. If you are ever lost regarding any step, you may refer to this document or reach out to the team on [MMC](https://discord.gg/yDjWBrGW)
#Git[gettingstarted](https://morrowind-modding.github.io/tags/gettingstarted)

View File

@ -12,4 +12,7 @@ I've run into many an inspiring obsidian as well as I've set up my own obsidian.
![asoka](https://media.giphy.com/media/QtjNbzT6Zi5Cm2oyV2/giphy.gif)
- This is an Obsidian [for TTRPGS](https://obsidianttrpgtutorials.com/Obsidian+TTRPG+Tutorials/Getting+Started/Vault+Structure) !! :O And [another](https://icewind.quest/) one!!
- This is an Obsidian [for TTRPGS](https://obsidianttrpgtutorials.com/Obsidian+TTRPG+Tutorials/Getting+Started/Vault+Structure) !! :O And [another](https://icewind.quest/) one!!
# Obsidian Blogs
- [Ellie's Notes](https://ellie.wtf)