Add README.md and LICENSE
This commit is contained in:
parent
adc7cffbd6
commit
c81ba11616
21
LICENSE
Normal file
21
LICENSE
Normal file
|
@ -0,0 +1,21 @@
|
|||
MIT License
|
||||
|
||||
Copyright (c) 2023 Edward Betts <edward@4angle.com>
|
||||
|
||||
Permission is hereby granted, free of charge, to any person obtaining a copy
|
||||
of this software and associated documentation files (the "Software"), to deal
|
||||
in the Software without restriction, including without limitation the rights
|
||||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
||||
copies of the Software, and to permit persons to whom the Software is
|
||||
furnished to do so, subject to the following conditions:
|
||||
|
||||
The above copyright notice and this permission notice shall be included in all
|
||||
copies or substantial portions of the Software.
|
||||
|
||||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
||||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
||||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
||||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
||||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
||||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
||||
SOFTWARE.
|
66
README.md
Normal file
66
README.md
Normal file
|
@ -0,0 +1,66 @@
|
|||
# Flickr Photo Finder for Wikipedia Articles
|
||||
|
||||
This tool is designed to help you find photos on Flickr for Wikipedia articles
|
||||
and contact the photographer. It's a Python application that leverages the Flask
|
||||
framework for web development.
|
||||
|
||||
## Table of Contents
|
||||
- [Introduction](#introduction)
|
||||
- [Usage](#usage)
|
||||
- [Error Handling](#error-handling)
|
||||
- [Running the Application](#running-the-application)
|
||||
|
||||
## Introduction
|
||||
|
||||
This tool is developed and maintained by Edward Betts (edward@4angle.com). Its
|
||||
primary purpose is to simplify the process of discovering and contacting
|
||||
photographers on Flickr whose photos can be used to enhance Wikipedia articles.
|
||||
|
||||
### Key Features
|
||||
- Search for Flickr photos related to specific Wikipedia articles.
|
||||
- Generate messages to request permission to use photos on Wikipedia.
|
||||
- Handle exceptions gracefully and provide detailed error information.
|
||||
|
||||
## Usage
|
||||
|
||||
To use the tool, follow these steps:
|
||||
|
||||
1. Start the tool by running the script.
|
||||
2. Access the tool through a web browser.
|
||||
3. Enter the Wikipedia URL for the article you want to find photos for.
|
||||
4. Optionally, provide a Flickr URL if you already have one in mind.
|
||||
5. The tool will extract relevant information and generate a message for you to
|
||||
request permission to use the photo on Wikipedia.
|
||||
|
||||
## Error Handling
|
||||
|
||||
The application includes error handling to ensure a smooth user experience. If
|
||||
an error occurs, it will display a detailed error message with traceback
|
||||
information. The error handling is designed to provide valuable insights into
|
||||
any issues that may arise during use.
|
||||
|
||||
## Running the Application
|
||||
|
||||
To run the application, ensure you have Python 3 installed on your system. You
|
||||
will also need to install the required Python modules mentioned in the script,
|
||||
including Flask, requests, and others.
|
||||
|
||||
1. Clone this repository to your local machine.
|
||||
2. Navigate to the project directory.
|
||||
3. Run the following command to start the application:
|
||||
|
||||
```bash
|
||||
python3 your_script_name.py
|
||||
```
|
||||
|
||||
Replace `your_script_name.py` with the actual name of your script.
|
||||
|
||||
4. Access the application by opening a web browser and visiting the provided URL
|
||||
(usually `http://localhost:5000/`).
|
||||
|
||||
That's it! You can now use the Flickr Photo Finder tool to streamline the process of finding and contacting photographers for Wikipedia articles.
|
||||
|
||||
If you encounter any issues or have questions, feel free to contact Edward Betts
|
||||
(edward@4angle.com).
|
||||
|
||||
Happy photo hunting!
|
Loading…
Reference in a new issue