lissarchive-website/README.md

34 lines
1.3 KiB
Markdown
Raw Normal View History

2020-05-04 21:58:03 +00:00
### About
2020-05-04 22:17:23 +00:00
This is the code for the website [https://lissarchive.org](https://lissarchive.org), an informational site for the LIS Scholarship Archive, a repository for LIS work. This site is built using [Nikola](https://getnikola.com/), a static site generator that relies on python3. The instructions for compiling and building the website are below.
2020-05-04 21:58:03 +00:00
### Building
I would recommend you use a virtualenv to build and view this website. This is a Python tool to create isolated Python environments. The HitchHiker's Guide to Python has a [great guide](http://docs.python-guide.org/en/latest/dev/virtualenvs/) on virtual environments that I used to learn how to use/interact with virtualenvs.
Here's how to make and activate a virtual environment:
<pre><code># install the tool virtualenv
$ pip install virtualenv
# create the Python 3 virtual environment
$ virtualenv -p python3 venv
# activate the virtual environment
$ source venv/bin/activate
</pre></code>
Now, you can get started and install all of the dependecies of this site in its own environment:
<pre><code># install the dependencies
$ pip install Nikola['extras']
# clone this repo
2020-05-04 22:17:23 +00:00
$ git clone git@gitlab.com:VickySteeves/lissarchive.git
2020-05-04 21:58:03 +00:00
# change directory (cd) so you are in the right folder for the website
2020-05-04 22:17:23 +00:00
$ cd lissarchive
2020-05-04 21:58:03 +00:00
# build the website
$ nikola build
# see the website
$ nikola serve -b
2020-05-04 22:17:23 +00:00
</pre></code>