Skip to content

Latest commit

 

History

History
51 lines (31 loc) · 1.6 KB

README.md

File metadata and controls

51 lines (31 loc) · 1.6 KB

lil-blog-generator

This app makes it easier to write blog posts for the LIL website.

Write your post using the WYSIWYG editor, then click the download button. You'll get a markdown file that you can upload straight to Github, following the on-screen instructions.

Running locally

  1. Install Poetry and install requirements:
poetry install
  1. Configure local settings:
echo "FLASK_SECRET_KEY=adjkahflashfjdlsahfjahlsdfa" >> .flaskenv
echo "FLASK_DEBUG=1" >> .flaskenv

(Recommended)

To bypass login locally:

echo "BYPASS_LOGIN=True" >> .flaskenv
  1. Run the Flask development server
poetry run flask run

For deployment, if you make changes to poetry.lock, e.g. with poetry add <package>, export the conventional requirements file:

poetry export -o requirements.txt

Authentication via Github

In production, this app authenticates via Github. Configuration can be found in the "Developer Settings > OAuth Apps" section of the LIL Github organization; the application looks for corresponding GITHUB_* env vars.

You can partially test the integration locally: does the redirect occur? Does the auth flow work as expected on the Github side?

But, after successfully authenticating, Github cannot, of course, hand things back to localhost.

So unless specifically working on authentication, you will likely want to disable login locally.