68 lines
1.6 KiB
Markdown
68 lines
1.6 KiB
Markdown
# ESV Bible Markdown
|
|
|
|
A Docker-based web service for serving the ESV Bible in Markdown format with chapter-by-chapter organization.
|
|
|
|
## Features
|
|
|
|
- Complete ESV Bible text in Markdown format from [lguenth/mdbible](https://github.com/lguenth/mdbible)
|
|
- Organized by book and chapter for easy navigation
|
|
- Docker containerized for easy deployment
|
|
- RESTful API for accessing Bible content
|
|
- Persistent volume storage for Bible data
|
|
- Optimized for remote hosting
|
|
|
|
## Setup
|
|
|
|
1. Clone this repository
|
|
2. The ESV Bible data will be automatically downloaded during Docker build from the GitHub repository
|
|
3. Run `docker-compose up --build`
|
|
|
|
## Usage
|
|
|
|
The service will be available at `http://localhost:3000`
|
|
|
|
### API Endpoints
|
|
|
|
- `GET /health` - Health check endpoint
|
|
- `GET /books` - List all available books
|
|
- `GET /books/:book` - Get complete book (all chapters combined)
|
|
- `GET /books/:book/:chapter` - Get specific chapter
|
|
|
|
### Example Usage
|
|
|
|
```bash
|
|
# List all books
|
|
curl http://localhost:3000/books
|
|
|
|
# Get the book of Genesis
|
|
curl http://localhost:3000/books/Genesis
|
|
|
|
# Get Genesis chapter 1
|
|
curl http://localhost:3000/books/Genesis/1
|
|
```
|
|
|
|
## Development
|
|
|
|
For local development:
|
|
```bash
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
## Docker Deployment
|
|
|
|
Build and run with Docker Compose:
|
|
```bash
|
|
docker-compose up --build
|
|
```
|
|
|
|
The Bible data is stored in a persistent Docker volume named `bible_data` for efficient storage and updates.
|
|
|
|
## Data Source
|
|
|
|
Bible content is sourced from [lguenth/mdbible](https://github.com/lguenth/mdbible/tree/main/by_chapter), which provides the ESV Bible organized by book and chapter in Markdown format.
|
|
|
|
## License
|
|
|
|
MIT
|