Skip to content
Permalink
master
Go to file
 
 
Cannot retrieve contributors at this time
executable file 57 lines (47 sloc) 4.3 KB

Development-Setup

These steps are neccessary to go debugging:

Windows

Running and working on Windows has its benefits and drawbacks. A major drawback is the clusterfuck that's called IIS and/or IIS Express. Because we use subdomains, you can either edit the bindings in IISExpress (and need to run it as admin), or use local IIS (and run Visual Studio as admin, because why the f not). Alas, here is the list of things to do:

  1. Download and Install Visual Studio (Community), 2015 or greater.
  2. Download the git distribution of your trust
  3. Download and Install node, and put npm in your path.
  4. Clone the project
  5. Open Visual Studio as Administrator (important)
  6. Install the full IIS in the Windows control panel. Make sure you install .NET with it. 5a. If you are on Windows 7, you additionally need to install the .NET Framework 4.5 into the IIS. Refer to the internet on how to do this.
  7. In Visual Studio, right-click on the Pokefans-Project, select Properties and select the "Web" tab. Use "Local IIS Debugging" with a base URL of "pokefans.rocks".
  8. Click "Create Virtual Directory". If there is an error, you may need to (a) adjust the project url in the Settings (b) add a binding to pokefans.rocks to your default web site in the IIS manager.
  9. Configure the Web.Config from the Pokefans project to suit your needs. Make sure all specified Paths exist or strange things may happen, including, but not limited to the apocalypse and the release of all your shinies.
  10. Open the NuGet Package Manager Console, and type in Update-Database to migrate the database to the newest version. Make sure "Pokefans" is your startup project and the connection string in the Web.confg is valid.
  11. It may be a good idea to run pokecli regen-search-index to regenerate the search indexes. If you load demo data, this is neccessary for searching (and a whole lot of other features) to work properly.
  12. Now run the project. Your browser should open and display your local pokefans start page. Important: this step needs node to function properly because nobody can compile CSS in, say, python.
  13. Register an account
  14. Use pokecli add-role -u <username> -r <role handle> to add yourself to the "mitarbeiter", "super-administrator", "moderator" and "role-manager" roles.
  15. Log out of the website and log in again. You can now go to mitarbeit.pokefans.rocks and use the user management system to give yourself the remaining roles.

Linux

  1. Download and Install mono
  2. Download and Install monodevelop
  3. Download and Install nodejs.
  4. If not already present, install xsp
  5. Clone and Build the Project
  6. Configure the Web.Config to your likings.
  7. run the dbtool to update the database.
  8. It may be a good idea to run pokecli regen-search-index to regenerate the search indexes. If you load demo data, this is neccessary for searching (and a whole lot of other features) to work properly.
  9. run the project and open pokefans.rocks in your browser.
  10. Register an account
  11. Use pokecli add-role -u <username> -r <role handle> to add yourself to the "mitarbeiter", "super-administrator", "moderator" and "role-manager" roles
  12. Log out of the website and log in again. You can now go to mitarbeit.pokefans.rocks and use the user management system to give yourself the remaining roles.

Mac OSX

  1. Install Visual Studio for Mac
  2. Install nodejs (eg. via Homebrew)
  3. Follow the Linux tutorial from Point 4 onwards.

Code-Style

See CodeStyle.cs in this Directory.

Installation

Please bear in mind that this is still in an early stage and an automated installer will most likely not be written as part of this project. So you have to execute some steps manually. I'd suggest running this under IIS with multiple domain bindings, as it simplifies stuff over IISExpress. XSP is fine, too.

Before running the project, make sure to make a new, empty database in your MariaDB instance. Edit the Connection String in web.config to your liking. Note that Auto-Seeding is off, so you need to manually do an Update-Database Command.

Then, register a user as you normally would. Connect to the database with the database tool of your choice, and put the user in (at least) these roles (here listed with their code handle)

  • moderator
  • superadmin
  • role-manager

This is enough to get you to the role manager for yourself, adding every other role within the GUI.

You can’t perform that action at this time.