You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
123 lines
3.9 KiB
Python
123 lines
3.9 KiB
Python
# IMPORT
|
|
import os
|
|
|
|
from flask import Flask, render_template, request, url_for, redirect, jsonify, abort, send_from_directory
|
|
import markdown
|
|
import frontmatter
|
|
from datetime import datetime
|
|
|
|
|
|
# FUNCTIONS
|
|
|
|
|
|
def list_files(folder, remove_ext=False):
|
|
''' Read all the functions in a folder '''
|
|
names = []
|
|
for entry in os.scandir(folder):
|
|
# add to the list only proper files
|
|
if entry.is_file(follow_symlinks=False):
|
|
# remove the extension from the filename
|
|
n = os.path.splitext(entry.name)[0]
|
|
if remove_ext:
|
|
n = entry.name
|
|
names.append(n)
|
|
return names
|
|
|
|
|
|
def list_folders(folder):
|
|
''' Return all the folders in a folder '''
|
|
names = []
|
|
for entry in os.scandir(folder):
|
|
# add to the list only proper files
|
|
if not entry.name.startswith('.') and entry.is_dir():
|
|
# remove the extension from the filename
|
|
names.append(entry.name)
|
|
return names
|
|
|
|
|
|
def get_md_contents(filename, directory='./contents'):
|
|
''' Return contents from a filename as frontmatter handler '''
|
|
with open(f"{directory}/{filename}", "r") as f:
|
|
metadata, content = frontmatter.parse(f.read())
|
|
html_content = markdown.markdown(content, extensions=['markdown.extensions.attr_list','markdown.extensions.codehilite','markdown.extensions.fenced_code'])
|
|
return metadata, html_content
|
|
|
|
|
|
# FLASK APP
|
|
base_url = "~kamo"
|
|
projects = 'projects'
|
|
|
|
# create flask application
|
|
app = Flask(__name__,
|
|
static_url_path=f'/soupboat/{base_url}/static',
|
|
static_folder=f'/soupboat/{base_url}/static')
|
|
# Markdown(app, extensions=['extra'])
|
|
# app.jinja_env.extend(jinja2_highlight_cssclass = 'codehilite')
|
|
|
|
|
|
# add the base_url variable to all the flask templates
|
|
@app.context_processor
|
|
def set_base_url():
|
|
return dict(base_url=base_url)
|
|
|
|
|
|
# Homepage
|
|
@app.route(f"/{base_url}/")
|
|
def home_page():
|
|
|
|
# get the basic info of the website from the /contents/home.md file
|
|
meta, content = get_md_contents("home.md")
|
|
projects_list = []
|
|
for project in list_folders("./projects"):
|
|
project_info = get_md_contents("documentation.md",
|
|
f"./{projects}/{project}")[0]
|
|
project_date = datetime.strptime(project_info['date'], '%d/%m/%Y')
|
|
project_info['date'] = datetime.strftime(project_date, '%d %b, %y')
|
|
project_info['categories'].sort()
|
|
|
|
project_info['slug'] = project
|
|
projects_list.append(project_info)
|
|
|
|
projects_list.sort(reverse=True, key=lambda project: datetime.strptime(
|
|
project['date'], '%d %b, %y'))
|
|
|
|
# get the list of the projects, the functions, and the corpora
|
|
home = {
|
|
**meta,
|
|
"content": content,
|
|
"projects": projects_list
|
|
}
|
|
return render_template("home.html", **home)
|
|
|
|
|
|
# For generic pages we can include a common template and change only the contents
|
|
@app.route(f"/{base_url}/<slug>/")
|
|
def dynamic_page(slug=None):
|
|
# meta is a dictionary that contains all the attributes in the markdown file (ex: title, description, soup, etc)
|
|
# content is the body of the md file aka the text content
|
|
# in this way we can access those frontmatter attributes in jinja simply using the variables title, description, soup, etc
|
|
meta, content = get_md_contents(f"{slug}.md")
|
|
return render_template("page.html", **meta, content=content)
|
|
|
|
|
|
# Single project
|
|
@app.route(f"/{base_url}/projects/<project>/")
|
|
def p_info(project=None):
|
|
meta, content = get_md_contents("documentation.md",
|
|
f"./{projects}/{project}")
|
|
template = 'project.html'
|
|
if 'template' in meta:
|
|
template = meta['template']
|
|
return render_template(template, **meta, content=content)
|
|
|
|
|
|
|
|
|
|
@app.route(f'/{base_url}/projects/<project>/<path:filename>')
|
|
def sendStaticFiles(project, filename):
|
|
return send_from_directory(app.root_path + f'/projects/{project}/', filename, conditional=True)
|
|
|
|
|
|
# RUN
|
|
app.run(port="3132")
|