https://github.com/machariamark/mygallery
A personal gallery application that displays my photos for all to see.
https://github.com/machariamark/mygallery
Last synced: 5 days ago
JSON representation
A personal gallery application that displays my photos for all to see.
- Host: GitHub
- URL: https://github.com/machariamark/mygallery
- Owner: MachariaMark
- License: mit
- Created: 2021-10-08T06:38:28.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-10-15T08:41:19.000Z (over 4 years ago)
- Last Synced: 2025-03-28T07:15:01.180Z (about 1 year ago)
- Language: Python
- Homepage: https://offgallery.herokuapp.com/
- Size: 26.7 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## My Gallery
8.10.2021
#### By **Mark Muchiri Macharia**
## Description
A personal gallery application that displays my photos for all to see. You can visit the live site on
https://offgallery.herokuapp.com/
## Features
As a user of the web application you will be able to:
1. See all posted photos
2. View photos by location
3. See each photo's description and location on hover.
4. Be able to copy a photo's url to the clipboard
5. Click on `view image` to expand a photo
6. Search for a photo by category e.g. _outdoor_, _photoshoot_
## Specifications
| Behavior | Input | Output |
| ------------------- | ----------------------------- | ----------------------------- |
| View all posted photos | Hover over a photo | Shown details about the photo |
Details about the photo | Click on `Copy Link` | Pop up that shows that the image link has been copied appears |
| Details about the photo | Click on `View Image` | Photo expands |
| Search in the search field | Input keywords to be searched then press ENTER | Search page is loaded and displays with the searched results |
## Getting started
### Prerequisites
* python3.6
* virtual environment
* pip
### Cloning
* In your terminal:
$ git clone https://github.com/MachariaMark/mygallery.git
$ cd mygallery
## Running the Application
* Install virtual environment using `$ python3.6 -m venv --without-pip virtual`
* Activate virtual environment using `$ source virtual/bin/activate`
* Download pip in our environment using `$ curl https://bootstrap.pypa.io/get-pip.py | python`
* Install all the dependencies from the requirements.txt file by running `python3.6 pip install -r requirements.txt`
* Create a database and edit the database configurations in `settings.py` to your own credentials.
* Make migrations
$ python manage.py makemigrations photos
$ python3.6 manage.py migrate
* To run the application, in your terminal:
$ python3.6 manage.py runserver
## Testing the Application
* To run the tests for the class file:
$ python3.6 manage.py test photos
## Technologies Used
* Python3.6
* Django
* HTML
* Bootstrap
This application is developed using [Python3.6](https://www.python.org/doc/), [Django](https://www.djangoproject.com/), [HTML](https://getbootstrap.com/) and [Bootstrap](https://getbootstrap.com/)
## Support and contact details
For feedback contact me through;
* mark.macharia@student.moringaschool.com
* 0759329269
### License
[MITlicense](LICENSE) 2021