Skip to content
Widget that shows trending topics discussed in Dutch municipalities
TypeScript Python CSS Shell HTML Dockerfile JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.vscode
backups
front
server
trends
.dockerignore
.gitignore
LICENSE
README.md
cronjob
dev.sh
docker-compose.dev.yml
docker-compose.yml
dockerfile
example.html
init-letsencrypt.sh
nginx.conf
nginx.dev.conf
redis.conf
renew.sh
secret_template.env
types.ts
variables.env

README.md

RaadsTalk

License: MIT

A webapplication that uses Open Raadsinformatie to show which topics are being discussed in Dutch municipalities. Uses the WeighWords library / Parsimonius algorithm to calculate which words are trending.

Check it out at VNG Realisatie or at raadstalk.nl!

Use as widget

Add this iFrame to your webpage:

  <iframe src="https://raadstalk.nl/widget" height="100%" width="100%" frameborder="o" scrolling="no">
    Raadstalk kan niet worden geladen. Bezoek <a href="https://raadstalk.nl">raadstalk.nl</a>
  </iframe>

Put it inside a wrapping element that constrains its width (about 250px) and height (about 400px).

See an example HTML file here.

Managing Topics

  • Visit admin.localhost (or admin.raadstalk.nl in production) and login using your credentials. The password is set with the secret.env file.
  • Manage months and their items by adjusting raadstalk.YYYY-MM. You can remove items from the lists.
  • Blacklist words / words to ignore can be set by adding items to raadstalk.stupid_words
  • Create backups by exporting the redis data and pasting the content to a new .redis file in the ./backups folder. You can import these using the same interface.

Local development

  • Setup the environment variables cd server && mv template.env .env
  • ./dev.sh
  • Visit http://localhost
  • Redis admin is available at http://localhost:8888 or http://admin.localhost
  • If you have VSCode, you can use the Debug server configuration for the back-end

Tasks

  • docker-compose up --build trends for running trends task to update the words
  • docker-compose up --build countall for updating trends task to update all counts
  • docker-compose up --build countlastmonth for updating trends task to update last months counts

Deployment & devops

  • Clone the repo to the server.
  • Clone the secret template file cp secret_templace.env secret.env and change the password.
  • For HTTPS, use ./init-letsencrypt.sh. Check this tutorial for more information.
  • cd raadstalk
  • Adjust variables.env to set start date.
  • Download the latest version and restart docker-compose ./renew.sh
  • Don't forget to periodically run trends crontab ./cronjob

Credits

Funded by VNG Realisatie B.V.

Development by Joep Meindertsma (@joepio) & Jurrian Trom (@jurrian) from Ontola / Argu B.V.

License

MIT

You can’t perform that action at this time.