diff --git a/README.md b/README.md index 2f35d486..6904c2bc 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 93263874..375bad00 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 02f3f81b..00000000 --- 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 26ffb1b1..00000000 --- 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 c04ebe32..00000000 --- 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 11bda092..00000000 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 9455168f..00000000 --- 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 eed0bd3f..00000000 --- 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 47ffd7f0..00000000 --- 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 e69de29b..00000000 diff --git a/documentation/docs/Usage/translate-your-site.md b/documentation/docs/Usage/translate-your-site.md deleted file mode 100644 index e69de29b..00000000 diff --git a/documentation/docs/Usage/updating.md b/documentation/docs/Usage/updating.md new file mode 100644 index 00000000..5d881cf2 --- /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 d79e5ea1..a343601d 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 1f092044..65399fb7 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 00000000..b2e6fc92 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 00000000..7a51945f 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 00000000..ed104ec6 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 00000000..25add10c 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 00000000..7b19478e 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 00000000..f60bf5fd 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 00000000..94577ff6 Binary files /dev/null and b/screenshots/regions.png differ