Initial commit

2022-03-28 18:44:08 -04:00
commit e43d9a90e7
267 changed files with 17049 additions and 0 deletions
@@ -0,0 +1,83 @@
+# Setup
+
+This document will contain general setup notes for the project.
+
+## Prerequisite
+
+To understand content in this document, it is recommended to have some software development experience. Particularly using GitHub and Visual Studio.
+
+- [GitHub Documentation](https://docs.github.com/en/get-started)
+
+- [Visual Studio Documentation](https://visualstudio.microsoft.com/vs/getting-started/)
+
+To make updates to this website, it is recommended to understand HTML/CSS and C#.
+
+- [C# Documentation](https://docs.microsoft.com/en-us/dotnet/csharp/)
+- [Mozilla's HTML Documentation](https://developer.mozilla.org/en-US/docs/Learn/HTML/Introduction_to_HTML/Getting_started)
+- [W3SCHOOLS' HTML Documentation](https://www.w3schools.com/html/)
+
+Further, you should understand the product and clients this website is for. So it is recommended to play "Immortal: Gates of Pyre".
+- [IGP Website](https://gatesofpyre.com/) 
+  - **Please Note:** This product currently has restricted access with it is in a pre-alpha state. If you are not aware or interested in IGP, I recommend to wait for product release. Otherwise, check out their discord for steps of getting access.
+
+
+## Installation
+
+Download and install Visual Studio preview.
+
+https://visualstudio.microsoft.com/vs/preview/
+
+When installing, ensure you have selected "Workloads | **ASP.NET and web development**" and "Individual components | **.NET WebAssembly build tools**".
+
+## Download Project
+
+Get this project from GitHub. 
+
+```bash
+git clone https://github.com/JonathanMcCaffrey/IGP-Fan-Reference.git
+```
+
+## Project Tree
+```
+C:.
+├───.github
+│   └───workflows       # Workflows to deploy website
+├───Components          # Components used be website
+├───Contexts
+├───IGP
+│   ├───Pages           # Website pages
+│   └───wwwroot     
+│       ├───css
+│       ├───generated   # Files generated by IGP_Convert. Do not edit
+│       ├───image
+│       ├───javascript
+│       └───markdown
+│           └───documentation       # Documentation files
+├───IGP_Convert         # Converts SQL into JSON for Blazor Wasm
+├───Model               # Data models
+└───Services            # Web services
+```
+
+## Running
+
+- Open `IGP/IGP.sln`. 
+- Click the green RUN button in Visual Studio.
+- A local copy of the IGP Website should have launched on your machine.
+
+
+## Publishing
+
+**Important:** publishing new version of the website will not occur until issue [39528](https://github.com/dotnet/aspnetcore/issues/39528) in dotnet/aspnetcore is resolved.
+
+
+Code committed to the `main` branch will automatically be deployed to [production](https://www.igpfanreference.com/).
+
+Code committed to the `develop` branch will automatically be deployed to [development](https://calm-mud-04916b210.1.azurestaticapps.net/).
+
+*This is handle via the files in `.github/workflow`. Look into these [GitHub Actions Documents](https://docs.github.com/en/actions) if curious about how this CI system works.*
+
+
+## Troubleshooting
+
+Nothing that some good internet searches cannot resolved. But you can also contact the project maintainer on [IGP Fan Reference](https://discord.gg/uMq8bMGeeN) Discord.
+