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.

To make updates to this website, it is recommended to understand HTML/CSS and C#.

Further, you should understand the product and clients this website is for. So it is recommended to play "Immortal: Gates of Pyre".

IGP Website
- 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.

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 in dotnet/aspnetcore is resolved.

Code committed to the main branch will automatically be deployed to production.

Code committed to the develop branch will automatically be deployed to development.

This is handle via the files in .github/workflow. Look into these GitHub Actions Documents 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 Discord.

3.2 KiB Raw Blame History