adds starlight docs
BIN
docs/src/assets/features.png
Normal file
|
After Width: | Height: | Size: 837 KiB |
BIN
docs/src/assets/houston.webp
Normal file
|
After Width: | Height: | Size: 96 KiB |
BIN
docs/src/assets/lists.png
Normal file
|
After Width: | Height: | Size: 882 KiB |
98
docs/src/assets/logo_dark.svg
Normal file
|
After Width: | Height: | Size: 10 KiB |
98
docs/src/assets/logo_light.svg
Normal file
|
After Width: | Height: | Size: 10 KiB |
BIN
docs/src/assets/new_trail.png
Normal file
|
After Width: | Height: | Size: 2.6 MiB |
BIN
docs/src/assets/pocketbase.png
Normal file
|
After Width: | Height: | Size: 435 KiB |
BIN
docs/src/assets/trail_list.png
Normal file
|
After Width: | Height: | Size: 1.0 MiB |
34
docs/src/components/button.svelte
Normal file
@@ -0,0 +1,34 @@
|
||||
<script lang="ts">
|
||||
export let type: "button" | "submit" | "reset" | null | undefined =
|
||||
undefined;
|
||||
export let icon: string = "";
|
||||
export let extraClasses: string = "";
|
||||
export let primary: boolean = false;
|
||||
export let secondary: boolean = false;
|
||||
export let large: boolean = false;
|
||||
export let loading: boolean = false;
|
||||
export let disabled: boolean = false;
|
||||
export let tooltip: string = "";
|
||||
</script>
|
||||
|
||||
<button
|
||||
class="{extraClasses} flex items-center justify-center"
|
||||
class:btn-primary={primary}
|
||||
class:btn-secondary={secondary}
|
||||
class:btn-large={large}
|
||||
class:btn-disabled={disabled || loading}
|
||||
disabled={disabled || loading}
|
||||
class:tooltip={tooltip.length > 0}
|
||||
data-title={tooltip}
|
||||
on:click
|
||||
{type}
|
||||
>
|
||||
{#if !loading}
|
||||
{#if icon}
|
||||
<i class="fa fa-{icon} mr-2"></i>
|
||||
{/if}
|
||||
<slot />
|
||||
{:else}
|
||||
<div class="spinner"></div>
|
||||
{/if}
|
||||
</button>
|
||||
6
docs/src/content/config.ts
Normal file
@@ -0,0 +1,6 @@
|
||||
import { defineCollection } from 'astro:content';
|
||||
import { docsSchema } from '@astrojs/starlight/schema';
|
||||
|
||||
export const collections = {
|
||||
docs: defineCollection({ schema: docsSchema() }),
|
||||
};
|
||||
11
docs/src/content/docs/guides/example.md
Normal file
@@ -0,0 +1,11 @@
|
||||
---
|
||||
title: Example Guide
|
||||
description: A guide in my new Starlight docs site.
|
||||
---
|
||||
|
||||
Guides lead a user through a specific task they want to accomplish, often with a sequence of steps.
|
||||
Writing a good guide requires thinking about what your users are trying to do.
|
||||
|
||||
## Further reading
|
||||
|
||||
- Read [about how-to guides](https://diataxis.fr/how-to-guides/) in the Diátaxis framework
|
||||
50
docs/src/content/docs/index.mdx
Normal file
@@ -0,0 +1,50 @@
|
||||
---
|
||||
title: Welcome to wanderer
|
||||
description: The self-hosted trail database
|
||||
template: splash
|
||||
hero:
|
||||
title: |
|
||||
Welcome to <span class="-tracking-[0.075em] s-y_bCXRrkrYfP">wanderer</span>
|
||||
tagline: <span class="-tracking-[0.075em] s-y_bCXRrkrYfP">wanderer</span> is a self-hosted trail database. You can upload your recorded GPS tracks or create new ones and add various metadata to build an easily searchable catalogue.
|
||||
image:
|
||||
file: ../../assets/logo_dark.svg
|
||||
actions:
|
||||
- text: Read the docs
|
||||
link: /guides/example/
|
||||
icon: right-arrow
|
||||
variant: primary
|
||||
- text: Visit the demo
|
||||
link: https://demo.wanderer.sh
|
||||
icon: external
|
||||
---
|
||||
|
||||
import { Card, CardGrid } from '@astrojs/starlight/components';
|
||||
import Button from '../../components/button.svelte';
|
||||
|
||||
## Features
|
||||
|
||||
<div class="grid grid-cols-1 md:grid-cols-3 gap-4">
|
||||
<div class="mt-4">
|
||||
<Card title="Manage your trails" icon="pencil">
|
||||
Upload your trails from multiple file formats (like GPX or TCX) or plan a new trail directly in <span class="-tracking-[0.075em] s-y_bCXRrkrYfP">wanderer</span> with the route drawing tool.
|
||||
|
||||
[Learn more →]()
|
||||
</Card>
|
||||
</div>
|
||||
<Card title="Advanced filters and search" icon="magnifier">
|
||||
<span class="-tracking-[0.075em] s-y_bCXRrkrYfP">wanderer</span> comes with extensive filter and search functionality right out of the box, so you can focus only on the trails relevant to you.
|
||||
</Card>
|
||||
<Card title="Full API support" icon="open-book">
|
||||
Use <span class="-tracking-[0.075em] s-y_bCXRrkrYfP">wanderer</span>'s API to interact with your trail data directly and automate the tasks that you don't want to do manually.
|
||||
|
||||
[API reference →]()
|
||||
</Card>
|
||||
</div>
|
||||
|
||||
## Contributing
|
||||
|
||||
Help is welcome at any time. Check out the [GitHub repository](https://github.com/Flomp/wanderer). to get started. If you are not sure where you can help, check the [roadmap](https://github.com/users/Flomp/projects/2) for features in the backlog. If you would like to contribute a translation, you can do so [here](https://crowdin.com/project/wanderer).
|
||||
|
||||
## Support <span class="-tracking-[0.075em] s-y_bCXRrkrYfP">wanderer</span>
|
||||
|
||||
<span class="-tracking-[0.075em] s-y_bCXRrkrYfP">wanderer</span> is a passion project and will always stay free and open-source. If you like <span class="-tracking-[0.075em] s-y_bCXRrkrYfP">wanderer</span> and want to support it's development you can make a small donation and [buy me a coffee](https://buymeacoffee.com/wanderertrails).
|
||||
11
docs/src/content/docs/reference/example.md
Normal file
@@ -0,0 +1,11 @@
|
||||
---
|
||||
title: Example Reference
|
||||
description: A reference page in my new Starlight docs site.
|
||||
---
|
||||
|
||||
Reference pages are ideal for outlining how things work in terse and clear terms.
|
||||
Less concerned with telling a story or addressing a specific use case, they should give a comprehensive outline of what your documenting.
|
||||
|
||||
## Further reading
|
||||
|
||||
- Read [about reference](https://diataxis.fr/reference/) in the Diátaxis framework
|
||||
2
docs/src/env.d.ts
vendored
Normal file
@@ -0,0 +1,2 @@
|
||||
/// <reference path="../.astro/types.d.ts" />
|
||||
/// <reference types="astro/client" />
|
||||
8
docs/src/tailwind.css
Normal file
@@ -0,0 +1,8 @@
|
||||
@tailwind base;
|
||||
@tailwind components;
|
||||
@tailwind utilities;
|
||||
|
||||
/*
|
||||
Add additional Tailwind styles to this file, for example with @layer:
|
||||
https://tailwindcss.com/docs/adding-custom-styles#using-css-and-layer
|
||||
*/
|
||||