Jump to content

Topic on Talk:VisualEditor/Installation on a shared host

How to edit the .gitignore?

3
FrustratedNoob (talkcontribs)

Okay, I'm not a programmer. How the heck do I edit the .gitignore file in step #4?

Can we possibly have some instructions that don't assume everyone who wants to use parsoid is a programmer?

First I installed and logged into the heroku CLI, then tried to download the git, but turns out I also need git, so I had to install and set up that. Then I get the git and I get to step 4 and there's no clue, not even a hint on how to do that it is asking. I searched everywhere in google for how to edit a file in heroku and came up with nothing usable, except mentions of its "ephemeral file system", which did not help me at all, no matter how I reworded it or used advanced google search modifiers.

So then I searched for how to download a file from heroku, and still nothing. There doesn't appear to be any kind of file manager in the heroku interface.. there has to be a way to open/edit files and edit them, or download them. I found references to installing vim but none of them worked. I'm very frustrated, please add some clear instructions for non-programmers to make this accessible to everyone who uses and administers a MediaWiki, and not just the programmers.

Mine is not the first comment regarding this. Others are having problems with the same thing. 14 steps when someone has no clue on how to use git or heroku is not a clear set of instructions at all. Please at least supply the necessary commands required to do the setup as other MediaWiki resources do.


Malyacko (talkcontribs)

Partially overlapping with Topic:Vp658eh047idd3mk. The page does not require any programming.

You edit the .gitignore file in the Parsoid directory by opening that file with a text editor. I have no idea about Heroku so feel free to ask in a Heroku forum how to edit files and to improve that page.

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. 'url' => 'https://APPNAME.herokuapp.com' NOT 'url' => 'https://APPNAME.herokuapp.com/'
Reply to "How to edit the .gitignore?"