updates to documentation

This commit is contained in:
Remy Moll 2022-09-26 15:32:05 +02:00
parent 9349b046d2
commit cca902b1f2
2 changed files with 12 additions and 8 deletions

View File

@ -77,18 +77,22 @@ docker compose --env-file env/production down
``` ```
### First run: ### First run:
> The program relies on a functioning chrome profile! > The program relies on a functioning firefox profile!
For the first run ever, run For the first run ever, run
`./launch init` `./launch edit_profile`
This will generate a new chrome profile under `coss_archiving/dependencies/news_fetch.profile`. This will generate a new firefox profile under `coss_archiving/dependencies/news_fetch.profile`.
You can then go to [http://localhost:7900](http://localhost:7900) in your browser. Verify the profile (under chrome://profile-internals). You can then go to [http://localhost:7900](http://localhost:7900) in your browser. Check the profile (under firefox://profile-internals).
Now install two addons: Idontcareaboutcookies (from chrome://extensions) and Bypass Paywalls (from https://github.com/iamadamdev/bypass-paywalls-chrome). The script already downloaded the file, so just enable developer mode, click load from unpacked, go to `/user_data/dependencies/news_fetch.profile`, select the directory `bypass-paywalls-chrome-master`. Now install two addons: Idontcareaboutcookies and bypass paywalls clean (from firefox://extensions). They ensure that most sites just work out of the box. You can additionally install adblockers such as ublock origin.
Whenever you need to make changes to the profile, for instance re-log in to websites, just rerun `./launch init`. You can then use this profile to further tweak various sites. The state of the sites (namely their cookies) will be used by `news_fetch`.
> Whenever you need to make changes to the profile, for instance re-log in to websites, just rerun `./launch edit_profile`.
Exit the mode by closing the firefox window. You can then run `./launch down` and then proceed normally.
## Building ## Building
@ -101,7 +105,7 @@ In docker compose, run
Or simpler, just run Or simpler, just run
`./launch build` `./launch build` (should issues occur you can also run `./launch build --no-cache`)

2
launch
View File

@ -55,7 +55,7 @@ then
### Fallback #### ### Fallback ####
else else
echo "Please specify the execution mode (debug/production/build) as the first argument" echo "Please specify the execution mode (debug/production/build/edit_profile/down) as the first argument"
exit 1 exit 1
fi fi