Jump to content

Topic on Project:Support desk

FrustratedNoob (talkcontribs)

Can someone please update the instructions on the following page so that they can be followed by people who aren't programmers? It is impossible to follow them currently without learning first how to program, how to install and set up git, and then use herokut. It shouldn't be that hard for an average MediaWiki user to install parsoid on Heroku because the instructions should be accessible to everyone. Thanks.

VisualEditor/Installation on a shared host

Malyacko (talkcontribs)

This comment does not make sense. The instructions on that page literally require zero programming.

If a specific line is unclear then please explain why and what you have tried and what happened instead.

Sentences a la "It shouldn't be that hard for an average electricity user to set up and build a nuclear power plant in their garden because the instructions should be accessible to everyone" don't really help though, I'm afraid.

TiltedCerebellum (talkcontribs)

Try the following (for people that don't know git, they don't realize that they aren't working remotely, they are working locally, and they aren't going to know the necessary git comands if they don't work with git all of the time):

  1. Make sure Git is installed (heroku requires Git).
  2. Install the Heroku Command Line Interface.
  3. Using Git CMD log in with:
    heroku login
    
  4. Clone Parsoid (to your local machine) with:
    git clone https://gerrit.wikimedia.org/r/mediawiki/services/parsoid
    
  5. Look at the location provided in your command prompt, your cloned files will be placed locally there e.g.: C:\Users\<user>\parsoid
  6. Enter the Parsoid directory you just created on your local machine:
    cd parsoid
    
  7. In Windows Explorer, browse to the path above on your local machine, and edit the hidden file .gitignore and remove the lines config.yaml and composer.lock
  8. In Windows Explorer, create your config file by copying config.example.yaml and renaming it to config.yaml
  9. Edit the config.yaml file you just created by changing the example URI for the URL of your API, for example uri: 'https://www.yoursite.wiki/api.php' If your wiki uses https, then uncomment the line strictSSL: false If the domain: 'localhost' line is uncommented, comment it (helps to avoid the "Invalid domain" error)
  10. Save the changes.
  11. Add the Heroku remote to your git repo with:
    heroku git:remote -a <yourappname>
    
  12. Stage the edited config files for committing with:
    git add .
    
  13. Commit your changes with:
    git commit -am "Initial commit"
    
  14. You have to specify an identifier to allow the commit with:
    git config user.email yourname@exaple.com
    
  15. Push and deploy your local changes to the remote location with:
    git push heroku master
    
  16. Visit https://yourappname.herokuapp.com to verify that your Parsoid service works.
  17. Make sure you DONT leave in the trailing slash in the LocalSettings.php portion of code, it will cause it to not work. I edited the MW page to remove the trailing slash.

Use: 'url' => 'https://APPNAME.herokuapp.com'

Do NOT use: 'url' => 'https://APPNAME.herokuapp.com/'