summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorblendoit <blendoit@gmail.com>2020-01-22 20:22:05 -0800
committerblendoit <blendoit@gmail.com>2020-01-22 20:22:05 -0800
commitd4b417b6d7c42440a4002aa183a9bb580429a6ec (patch)
tree6e3c7c690d7c73f63e9bae333c3d69c57d9b9083
parentb8aa5096f60f3afd8b0fd31eab96bff8312c9231 (diff)
Added prereqs, usage and installation instructions
-rw-r--r--README.org15
-rw-r--r--README.pdfbin169263 -> 176463 bytes
-rw-r--r--README.tex50
3 files changed, 52 insertions, 13 deletions
diff --git a/README.org b/README.org
index d3fa4ea..4197c41 100644
--- a/README.org
+++ b/README.org
@@ -35,3 +35,18 @@
*** =forms.py=
This Python file contains the forms that our user will sign in throughout the website (registration, login). Possible implementation of the messaging system as a series of forms sent from user to user.
+
+* Prerequisites
+
+ 1. A Python interpreter and the following dependencies:
+ 1. =Flask=
+ 2. A web browser
+
+* Installation
+
+ Install Python.
+
+* Viewing the website
+
+ 1. Run the =routes.py= script using your Python interpreter.
+ 2. Visit =127.0.0.1= on your web browser.
diff --git a/README.pdf b/README.pdf
index 07be55f..9859189 100644
--- a/README.pdf
+++ b/README.pdf
Binary files differ
diff --git a/README.tex b/README.tex
index fb73f05..0483e29 100644
--- a/README.tex
+++ b/README.tex
@@ -1,4 +1,4 @@
-% Created 2020-01-22 Wed 19:35
+% Created 2020-01-22 Wed 20:21
% Intended LaTeX compiler: pdflatex
\documentclass[11pt]{article}
\usepackage[utf8]{inputenc}
@@ -32,48 +32,72 @@
\section{Folder structure}
-\label{sec:org4938adb}
+\label{sec:org7993fb5}
\subsection{\texttt{Pipfile}}
-\label{sec:orgd7f1aa1}
+\label{sec:org80836f9}
Inspecting this file reveals the Python dependencies required by the Flask application.
-The convenient \texttt{pipenv} Python package bundles together the creation of virtual environments and populating these virtual environments using the same commands as \texttt{pip}. For more information on \texttt{pipenv}, visit \href{https:github.com/pypa/pipenv}{the official pipenv page}.
+The convenient \texttt{pipenv} Python package bundles together the creation of virtual environments and populating these virtual environments using the same commands as \texttt{pip}. For more information on \texttt{pipenv}, visit \href{https://github.com/pypa/pipenv}{the official pipenv page}.
\subsection{\texttt{Pipfile.lock}}
-\label{sec:org27c90c7}
+\label{sec:orgf06ab89}
This file contains checksums for the packages installed via \texttt{pipenv}.
\subsection{\texttt{README.org}}
-\label{sec:org87e8b71}
+\label{sec:org1715543}
This is the file you are currently reading. Github automatically formats README files and presents underneath the code explorer.
\subsection{\texttt{app} directory}
-\label{sec:org8b8aa68}
+\label{sec:org67d9e1d}
Contains \texttt{.py} Python scripts calling the \texttt{Flask} library in order to serve web pages to the end user.
\subsubsection{\texttt{static}}
-\label{sec:org75f3ff4}
+\label{sec:org250fc10}
Static files and assets do not change during the \texttt{Flask} application's execution.
\begin{enumerate}
\item \texttt{img}
-\label{sec:org227be90}
+\label{sec:org6b963c3}
This is where website images are saved. User images will be stored in a database, which is currently not implemented.
\item \texttt{styles}
-\label{sec:org52a88e7}
+\label{sec:org860737a}
Here, we store \texttt{CSS} style sheets. These contain appearance information for elements described in \texttt{HTML} documents.
\end{enumerate}
\subsubsection{\texttt{templates}}
-\label{sec:org24e0e72}
+\label{sec:orgae70d36}
In the templates folder, we organise our \texttt{HTML} templates. Rather than simple \texttt{HTML} documents which always present the same content to all users, templates are rendered to the user's browser by the application and are populated during loading with content we can request via the Python application.
\subsubsection{\texttt{routes.py}}
-\label{sec:orgc4dc0be}
+\label{sec:orge3ac7eb}
This Python file containes our website routes. These are the names of our website's pages, followed by functions describing actions performed on the server side every time a user visits a certain page.
\subsubsection{\texttt{forms.py}}
-\label{sec:orgb8c7f76}
+\label{sec:org934f5b3}
This Python file contains the forms that our user will sign in throughout the website (registration, login). Possible implementation of the messaging system as a series of forms sent from user to user.
+
+\section{Prerequisites}
+\label{sec:orgf8c00d7}
+
+\begin{enumerate}
+\item A Python interpreter and the following dependencies:
+\begin{enumerate}
+\item \texttt{Flask}
+\end{enumerate}
+\item A web browser
+\end{enumerate}
+
+\section{Installation}
+\label{sec:org41d3c46}
+
+Install Python.
+
+\section{Viewing the website}
+\label{sec:orgff7b5c7}
+
+\begin{enumerate}
+\item Run the \texttt{routes.py} script using your Python interpreter.
+\item Visit \texttt{127.0.0.1} on your web browser.
+\end{enumerate}
\end{document}
Copyright 2019--2024 Marius PETER