diff --git a/README.md b/README.md index 2f35d48..6904c2b 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,23 @@ # AdventureLog: Embark, Explore, Remember. 🌍 -_**⚠️ AdventureLog is in early development and is not recommended for production use until version 1.0!**_ - ### _"Never forget an adventure with AdventureLog - Your ultimate travel companion!"_ ---- +**Documentation can be found [here](https://docs.adventurelog.app).** + +# Table of Contents + +- [Installation](#installation) + - [Docker πŸ‹](#docker-) + - [Prerequisites](#prerequisites) + - [Getting Started](#getting-started) + - [Configuration](#configuration) + - [Frontend Container (web)](#frontend-container-web) + - [Backend Container (server)](#backend-container-server) + - [Proxy Container (nginx) Configuration](#proxy-container-nginx-configuration) + - [Running the Containers](#running-the-containers) +- [Screenshots πŸ–ΌοΈ](#screenshots) +- [About AdventureLog](#about-adventurelog) +- [Attribution](#attribution) # Installation @@ -82,6 +95,27 @@ docker compose up -d Enjoy AdventureLog! πŸŽ‰ +# Screenshots + +![Adventure Page](screenshots/adventures.png) +Displaying the adventures you have visited and the ones you plan to embark on. You can also filter and sort the adventures. + +![Detail Page](screenshots/details.png) +Shows specific details about an adventure, including the name, date, location, description, and rating. + +![Edit](screenshots/edit.png) + +![Map Page](screenshots/map.png) +View all of your adventures on a map, with the ability to filter by visit status and add new ones by click on the map. + +![Itinerary Page](screenshots/itinerary.png) + +![Country Page](screenshots/countries.png) + +![Region Page](screenshots/regions.png) + +️ + # About AdventureLog AdventureLog is a Svelte Kit and Django application that utilizes a PostgreSQL database. Users can log the adventures they have experienced, as well as plan future ones. Key features include: diff --git a/docker-compose.yml b/docker-compose.yml index 9326387..375bad0 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -8,9 +8,7 @@ services: - PUBLIC_SERVER_URL=http://server:8000 - ORIGIN=http://localhost:8080 - BODY_SIZE_LIMIT=Infinity - # Analytics can be configured here using Umami (https://umami.is) - ENABLE_ANALYTICS=false - #- UNAMI_KEY='' ports: - "8080:3000" depends_on: @@ -60,14 +58,3 @@ services: volumes: postgres_data: adventurelog_media: -# -# nginx: -# build: -# context: ./proxy/ -# dockerfile: Dockerfile.nginx -# ports: -# - "81:80" # Using port 81 to avoid conflict with your existing setup -# volumes: -# - adventurelog_media:/app/media -# depends_on: -# - server diff --git a/documentation/blog/2019-05-28-first-blog-post.md b/documentation/blog/2019-05-28-first-blog-post.md deleted file mode 100644 index 02f3f81..0000000 --- a/documentation/blog/2019-05-28-first-blog-post.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -slug: first-blog-post -title: First Blog Post -authors: - name: Gao Wei - title: Docusaurus Core Team - url: https://github.com/wgao19 - image_url: https://github.com/wgao19.png -tags: [hola, docusaurus] ---- - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet diff --git a/documentation/blog/2019-05-29-long-blog-post.md b/documentation/blog/2019-05-29-long-blog-post.md deleted file mode 100644 index 26ffb1b..0000000 --- a/documentation/blog/2019-05-29-long-blog-post.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -slug: long-blog-post -title: Long Blog Post -authors: endi -tags: [hello, docusaurus] ---- - -This is the summary of a very long blog post, - -Use a `` comment to limit blog post size in the list view. - - - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet - -Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque elementum dignissim ultricies. Fusce rhoncus ipsum tempor eros aliquam consequat. Lorem ipsum dolor sit amet diff --git a/documentation/blog/2021-08-01-mdx-blog-post.mdx b/documentation/blog/2021-08-01-mdx-blog-post.mdx deleted file mode 100644 index c04ebe3..0000000 --- a/documentation/blog/2021-08-01-mdx-blog-post.mdx +++ /dev/null @@ -1,20 +0,0 @@ ---- -slug: mdx-blog-post -title: MDX Blog Post -authors: [slorber] -tags: [docusaurus] ---- - -Blog posts support [Docusaurus Markdown features](https://docusaurus.io/docs/markdown-features), such as [MDX](https://mdxjs.com/). - -:::tip - -Use the power of React to create interactive blog posts. - -```js - -``` - - - -::: diff --git a/documentation/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg b/documentation/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg deleted file mode 100644 index 11bda09..0000000 Binary files a/documentation/blog/2021-08-26-welcome/docusaurus-plushie-banner.jpeg and /dev/null differ diff --git a/documentation/blog/2021-08-26-welcome/index.md b/documentation/blog/2021-08-26-welcome/index.md deleted file mode 100644 index 9455168..0000000 --- a/documentation/blog/2021-08-26-welcome/index.md +++ /dev/null @@ -1,25 +0,0 @@ ---- -slug: welcome -title: Welcome -authors: [slorber, yangshun] -tags: [facebook, hello, docusaurus] ---- - -[Docusaurus blogging features](https://docusaurus.io/docs/blog) are powered by the [blog plugin](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-blog). - -Simply add Markdown files (or folders) to the `blog` directory. - -Regular blog authors can be added to `authors.yml`. - -The blog post date can be extracted from filenames, such as: - -- `2019-05-30-welcome.md` -- `2019-05-30-welcome/index.md` - -A blog post folder can be convenient to co-locate blog post images: - -![Docusaurus Plushie](./docusaurus-plushie-banner.jpeg) - -The blog supports tags as well! - -**And if you don't want a blog**: just delete this directory, and use `blog: false` in your Docusaurus config. diff --git a/documentation/docs/Installation/congratulations.md b/documentation/docs/Installation/congratulations.md deleted file mode 100644 index eed0bd3..0000000 --- a/documentation/docs/Installation/congratulations.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -sidebar_position: 3 ---- - -# Congratulations! πŸŽ‰ - -You have just learned the **basics of Docusaurus** and made some changes to the **initial template**. - -Docusaurus has **much more to offer**! - -Anything **unclear** or **buggy** in this tutorial? [Please report it!](https://github.com/facebook/docusaurus/discussions/4610) - -## What's next? - -- Read the [official documentation](https://docusaurus.io/) -- Modify your site configuration with [`docusaurus.config.js`](https://docusaurus.io/docs/api/docusaurus-config) -- Add navbar and footer items with [`themeConfig`](https://docusaurus.io/docs/api/themes/configuration) -- Add a custom [Design and Layout](https://docusaurus.io/docs/styling-layout) -- Add a [search bar](https://docusaurus.io/docs/search) -- Find inspirations in the [Docusaurus showcase](https://docusaurus.io/showcase) -- Get involved in the [Docusaurus Community](https://docusaurus.io/community/support) diff --git a/documentation/docs/Installation/local.md b/documentation/docs/Installation/local.md deleted file mode 100644 index 47ffd7f..0000000 --- a/documentation/docs/Installation/local.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -sidebar_position: 2 ---- - -# Local πŸ–₯️ diff --git a/documentation/docs/Usage/manage-docs-versions.md b/documentation/docs/Usage/manage-docs-versions.md deleted file mode 100644 index e69de29..0000000 diff --git a/documentation/docs/Usage/translate-your-site.md b/documentation/docs/Usage/translate-your-site.md deleted file mode 100644 index e69de29..0000000 diff --git a/documentation/docs/Usage/updating.md b/documentation/docs/Usage/updating.md new file mode 100644 index 0000000..5d881cf --- /dev/null +++ b/documentation/docs/Usage/updating.md @@ -0,0 +1,28 @@ +--- +sidebar_position: 1 +--- + +# Updating + +Updating AdventureLog when using docker can be quite easy. Run the folowing commands to pull the latest version and restart the containers. Make sure you backup your instance before updating just in case! + +Note: Make sure you are in the same directory as your `docker-compose.yml` file. + +```bash +docker compose pull +docker compose up -d +``` + +## Updating the Region Data + +Region data in AdventureLog is stored in a seeding file. This file can change and there is an easy command to resync the region data without needing any database changes. This can be run by acessing the contianers terminal as follows. + +```bash +docker exec -it bash +``` + +Once you are in the container run the following command to resync the region data. + +```bash +python manage.py worldtravel-seed --force +``` diff --git a/documentation/docs/intro.md b/documentation/docs/intro.md index d79e5ea..a343601 100644 --- a/documentation/docs/intro.md +++ b/documentation/docs/intro.md @@ -6,4 +6,4 @@ sidebar_position: 1 This tutorial will guide you how to get AdventureLog up and running on your local machine quickly and easily. -Choose a next below to get started: +Click next below to get started: diff --git a/documentation/docusaurus.config.ts b/documentation/docusaurus.config.ts index 1f09204..65399fb 100644 --- a/documentation/docusaurus.config.ts +++ b/documentation/docusaurus.config.ts @@ -4,7 +4,7 @@ import type * as Preset from "@docusaurus/preset-classic"; const config: Config = { title: "Adventure Log", - tagline: "AdventureLog: Embark, Explore, Remember. 🌍", + tagline: "Embark, Explore, Remember. πŸ—ΊοΈ", favicon: "img/favicon.png", // Set the production url of your site here @@ -42,13 +42,13 @@ const config: Config = { editUrl: "https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/", }, - blog: { - showReadingTime: true, - // Please change this to your repo. - // Remove this to remove the "edit this page" links. - editUrl: - "https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/", - }, + // blog: { + // showReadingTime: true, + // // Please change this to your repo. + // // Remove this to remove the "edit this page" links. + // editUrl: + // "https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/", + // }, theme: { customCss: "./src/css/custom.css", }, @@ -77,7 +77,7 @@ const config: Config = { position: "left", label: "Documentation", }, - { to: "/blog", label: "Blog", position: "left" }, + // { to: "/blog", label: "Blog", position: "left" }, { href: "https://github.com/seanmorley15/adventurelog", label: "GitHub", @@ -95,40 +95,32 @@ const config: Config = { label: "Intro", to: "/docs/intro", }, + { + label: "Installation", + to: "/docs/Installation/docker", + }, ], }, { title: "Community", items: [ - { - label: "Stack Overflow", - href: "https://stackoverflow.com/questions/tagged/docusaurus", - }, - { - label: "Discord", - href: "https://discordapp.com/invite/docusaurus", - }, - { - label: "Twitter", - href: "https://twitter.com/docusaurus", - }, - ], - }, - { - title: "More", - items: [ - { - label: "Blog", - to: "/blog", - }, { label: "GitHub", - href: "https://github.com/facebook/docusaurus", + href: "https://github.com/seanmorley15/adventurelog", }, ], }, + // { + // title: "More", + // items: [ + // { + // label: "Blog", + // to: "/blog", + // }, + // ], + // }, ], - copyright: `Copyright Β© ${new Date().getFullYear()} My Project, Inc. Built with Docusaurus.`, + copyright: `Copyright Β© ${new Date().getFullYear()} Sean Morley Built with Docusaurus.`, }, prism: { theme: prismThemes.github, diff --git a/screenshots/adventures.png b/screenshots/adventures.png new file mode 100644 index 0000000..b2e6fc9 Binary files /dev/null and b/screenshots/adventures.png differ diff --git a/screenshots/countries.png b/screenshots/countries.png new file mode 100644 index 0000000..7a51945 Binary files /dev/null and b/screenshots/countries.png differ diff --git a/screenshots/details.png b/screenshots/details.png new file mode 100644 index 0000000..ed104ec Binary files /dev/null and b/screenshots/details.png differ diff --git a/screenshots/edit.png b/screenshots/edit.png new file mode 100644 index 0000000..25add10 Binary files /dev/null and b/screenshots/edit.png differ diff --git a/screenshots/itinerary.png b/screenshots/itinerary.png new file mode 100644 index 0000000..7b19478 Binary files /dev/null and b/screenshots/itinerary.png differ diff --git a/screenshots/map.png b/screenshots/map.png new file mode 100644 index 0000000..f60bf5f Binary files /dev/null and b/screenshots/map.png differ diff --git a/screenshots/regions.png b/screenshots/regions.png new file mode 100644 index 0000000..94577ff Binary files /dev/null and b/screenshots/regions.png differ