6 changed files with 1080 additions and 744 deletions
@ -1,29 +1,37 @@
@@ -1,29 +1,37 @@
|
||||
<script lang="ts"> |
||||
import { DarkMode, Navbar, NavLi, NavUl, NavHamburger, NavBrand } from 'flowbite-svelte'; |
||||
import Login from './Login.svelte'; |
||||
import { |
||||
DarkMode, |
||||
Navbar, |
||||
NavLi, |
||||
NavUl, |
||||
NavHamburger, |
||||
NavBrand, |
||||
} from "flowbite-svelte"; |
||||
import Login from "./Login.svelte"; |
||||
|
||||
let { class: className = '' } = $props(); |
||||
let { class: className = "" } = $props(); |
||||
|
||||
let leftMenuOpen = $state(false); |
||||
</script> |
||||
|
||||
<Navbar class={`Navbar navbar-leather ${className}`}> |
||||
<div class='flex flex-grow justify-between'> |
||||
<NavBrand href='/'> |
||||
<div class="flex flex-grow justify-between"> |
||||
<NavBrand href="/"> |
||||
<h1>Alexandria</h1> |
||||
</NavBrand> |
||||
</div> |
||||
<div class='flex md:order-2'> |
||||
<div class="flex md:order-2"> |
||||
<Login /> |
||||
<NavHamburger class='btn-leather' /> |
||||
<NavHamburger class="btn-leather" /> |
||||
</div> |
||||
<NavUl class='ul-leather'> |
||||
<NavLi href='/new/edit'>Publish</NavLi> |
||||
<NavLi href='/visualize'>Visualize</NavLi> |
||||
<NavLi href='/about'>About</NavLi> |
||||
<NavLi href='/contact'>Contact</NavLi> |
||||
<NavUl class="ul-leather"> |
||||
<NavLi href="/new/edit">Publish</NavLi> |
||||
<NavLi href="/visualize">Visualize</NavLi> |
||||
<NavLi href="/start">Getting Started</NavLi> |
||||
<NavLi href="/about">About</NavLi> |
||||
<NavLi href="/contact">Contact</NavLi> |
||||
<NavLi> |
||||
<DarkMode btnClass='btn-leather p-0'/> |
||||
<DarkMode btnClass="btn-leather p-0" /> |
||||
</NavLi> |
||||
</NavUl> |
||||
</Navbar> |
||||
|
||||
@ -0,0 +1,174 @@
@@ -0,0 +1,174 @@
|
||||
<script lang="ts"> |
||||
import { Heading, Img, P, A } from "flowbite-svelte"; |
||||
|
||||
// Get the git tag version from environment variables |
||||
const appVersion = import.meta.env.APP_VERSION || "development"; |
||||
const isVersionKnown = appVersion !== "development"; |
||||
</script> |
||||
|
||||
<div class="w-full flex justify-center"> |
||||
<main class="main-leather flex flex-col space-y-6 max-w-2xl w-full my-6 px-4"> |
||||
<Heading tag="h1" class="h-leather mb-2" |
||||
>Getting Started with Alexandria</Heading |
||||
> |
||||
|
||||
<Heading tag="h2" class="h-leather mt-4 mb-2">Overview</Heading> |
||||
|
||||
<P class="mb-4"> |
||||
Alexandria opens up to the <A href="./">landing page</A>, where the user |
||||
can: login (top-right), select whether to only view the publications |
||||
hosted on the <A href="https://thecitadel.nostr1.com/" target="_blank" |
||||
>thecitadel document relay</A |
||||
> or add in their own relays, and scroll/search the publications. |
||||
</P> |
||||
|
||||
<div class="flex flex-col items-center space-y-4 my-4"> |
||||
<Img |
||||
src="/screenshots/LandingPage.png" |
||||
alt="Landing page" |
||||
class="image-border rounded-lg" |
||||
width="400" |
||||
/> |
||||
<Img |
||||
src="/screenshots/YourRelays.png" |
||||
alt="Relay selection" |
||||
class="image-border rounded-lg" |
||||
width="400" |
||||
/> |
||||
</div> |
||||
|
||||
<P class="mb-3"> |
||||
There is also the ability to view the publications as a diagram, if you |
||||
click on "Visualize", and to publish an e-book or other document (coming |
||||
soon). |
||||
</P> |
||||
|
||||
<P class="mb-3"> |
||||
If you click on a card, which represents a 30040 index event, the |
||||
associated reading view opens to the publication. The app then pulls all |
||||
of the content events (30041s and 30818s for wiki pages), in the order in |
||||
which they are indexed, and displays them as a single document. |
||||
</P> |
||||
|
||||
<P class="mb-3"> |
||||
Each content section (30041 or 30818) is also a level in the table of |
||||
contents, which can be accessed from the floating icon top-left in the |
||||
reading view. This allows for navigation within the publication. (This |
||||
functionality has been temporarily disabled.) |
||||
</P> |
||||
|
||||
<div class="flex flex-col items-center space-y-4 my-4"> |
||||
<Img |
||||
src="/screenshots/ToC_icon.png" |
||||
alt="ToC icon" |
||||
class="image-border rounded-lg" |
||||
width="400" |
||||
/> |
||||
<Img |
||||
src="/screenshots/TableOfContents.png" |
||||
alt="Table of contents example" |
||||
class="image-border rounded-lg" |
||||
width="400" |
||||
/> |
||||
</div> |
||||
|
||||
<Heading tag="h2" class="h-leather mt-4 mb-2">Typical use cases</Heading> |
||||
|
||||
<Heading tag="h3" class="h-leather mb-3">For e-books</Heading> |
||||
|
||||
<P class="mb-3"> |
||||
The most common use for Alexandria is for e-books: both those the users |
||||
have written themselves and those uploaded to Nostr from other sources. |
||||
The first minor version of the app, Gutenberg, is focused on displaying |
||||
and producing these publications. |
||||
</P> |
||||
|
||||
<P class="mb-3"> |
||||
An example of a book is <A |
||||
href="/publication?d=jane-eyre-an-autobiography-by-charlotte-bront%C3%AB-v-3rd-edition" |
||||
>Jane Eyre</A |
||||
> |
||||
</P> |
||||
|
||||
<div class="flex justify-center my-4"> |
||||
<Img |
||||
src="/screenshots/JaneEyre.png" |
||||
alt="Jane Eyre, by Charlotte Brontë" |
||||
class="image-border rounded-lg" |
||||
width="400" |
||||
/> |
||||
</div> |
||||
|
||||
<Heading tag="h3" class="h-leather mb-3">For scientific papers</Heading> |
||||
|
||||
<P class="mb-3"> |
||||
Alexandria will also display research papers with Asciimath and LaTeX |
||||
embedding, and the normal advanced formatting options available for |
||||
Asciidoc. In addition, we will be implementing special citation events, |
||||
which will serve as an alternative or addition to the normal footnotes. |
||||
</P> |
||||
|
||||
<P class="mb-3"> |
||||
Correctly displaying such papers, integrating citations, and allowing them |
||||
to be reviewed (with kind 1111 comments), and annotated (with highlights) |
||||
by users, is the focus of the second minor version, Euler. |
||||
</P> |
||||
|
||||
<P class="mb-3"> |
||||
Euler will also pioneer the HTTP-based (rather than websocket-based) |
||||
e-paper compatible version of the web app. |
||||
</P> |
||||
|
||||
<P class="mb-3"> |
||||
An example of a research paper is <A |
||||
href="/publication?d=less-partnering-less-children-or-both-by-julia-hellstrand-v-1" |
||||
>Less Partnering, Less Children, or Both?</A |
||||
> |
||||
</P> |
||||
|
||||
<div class="flex justify-center my-4"> |
||||
<Img |
||||
src="/screenshots/ResearchPaper.png" |
||||
alt="Research paper" |
||||
class="image-border rounded-lg" |
||||
width="400" |
||||
/> |
||||
</div> |
||||
|
||||
<Heading tag="h3" class="h-leather mb-3">For documentation</Heading> |
||||
|
||||
<P class="mb-3"> |
||||
Our own team uses Alexandria to document the app, to display our <A |
||||
href="/publication?d=the-gitcitadel-blog-by-stella-v-1">blog entries</A |
||||
>, as well as to store copies of our most interesting <A |
||||
href="/publication?d=gitcitadel-project-documentation-by-stella-v-1" |
||||
>technical specifications</A |
||||
>. |
||||
</P> |
||||
|
||||
<div class="flex justify-center my-4"> |
||||
<Img |
||||
src="/screenshots/Documentation.png" |
||||
alt="Documentation" |
||||
class="image-border rounded-lg" |
||||
width="400" |
||||
/> |
||||
</div> |
||||
|
||||
<Heading tag="h3" class="h-leather mb-3">For wiki pages</Heading> |
||||
|
||||
<P class="mb-3"> |
||||
Alexandria now supports wiki pages (kind 30818), allowing for |
||||
collaborative knowledge bases and documentation. Wiki pages, such as this |
||||
one about the <A href="/publication?d=sybil">Sybil utility</A> use the same |
||||
Asciidoc format as other publications but are specifically designed for interconnected, |
||||
evolving content. |
||||
</P> |
||||
|
||||
<P class="mb-3"> |
||||
Wiki pages can be linked to from other publications and can contain links |
||||
to other wiki pages, creating a web of knowledge that can be navigated and |
||||
explored. |
||||
</P> |
||||
</main> |
||||
</div> |
||||
Loading…
Reference in new issue