diff --git a/src/routes/about/+page.svelte b/src/routes/about/+page.svelte index ace2103..eb0abfc 100644 --- a/src/routes/about/+page.svelte +++ b/src/routes/about/+page.svelte @@ -1,118 +1,214 @@ - -
-
+
+
- About the Library of Alexandria + About the Library of Alexandria {#if isVersionKnown} - Version: {appVersion} + Version: {appVersion} {/if}
Alexandria icon

- Alexandria is a reader and writer for curated publications (in Asciidoc), wiki pages (Asciidoc), and will eventually also support long-form articles (Markdown). It is produced by the GitCitadel project team. -

- -

- Please submit support issues on the Alexandria repo page and follow us on GitHub and Geyserfund. -

- -

- We are easiest to contact over our Nostr address npub1s3h…75wz. -

- - Overview - -

- Alexandria opens up to the landing page, where the user can: login (top-right), select whether to only view the publications hosted on the thecitadel document relay or add in their own relays, and scroll/search the publications. -

- -
- Landing page - Relay selection -
- -

- 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). -

- -

- 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. -

- -

- 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.) -

- -
- ToC icon - Table of contents example -
- - Typical use cases - - For e-books - -

- The most common use for Alexandria is for e-books: both those 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. -

- -

- An example of a book is Jane Eyre -

- -
- Jane Eyre, by Charlotte Brontë -
- - For scientific papers - -

- 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. -

- -

- 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. -

- -

- Euler will also pioneer the HTTP-based (rather than websocket-based) e-paper compatible version of the web app. -

- -

- An example of a research paper is Less Partnering, Less Children, or Both? -

- -
- Research paper -
- - For documentation - -

- Our own team uses Alexandria to document the app, to display our blog entries, as well as to store copies of our most interesting technical specifications. -

- -
- Documentation -
- - For wiki pages - -

- Alexandria now supports wiki pages (kind 30818), allowing for collaborative knowledge bases and documentation. Wiki pages use the same Asciidoc format as other publications but are specifically designed for interconnected, evolving content. -

- -

- 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. -

- -
+ Alexandria is a reader and writer for curated publications (in Asciidoc), wiki pages (Asciidoc), and will eventually also support long-form + articles (Markdown). It is produced by the GitCitadel project team. +

+ +

+ Please submit support issues on the Alexandria repo page and follow us on GitHub and Geyserfund. +

+ +

+ We are easiest to contact over our Nostr address npub1s3h…75wz. +

+ + Overview + +

+ Alexandria opens up to the landing page, where the user + can: login (top-right), select whether to only view the publications + hosted on the thecitadel document relay or add in their own relays, and scroll/search the publications. +

+ +
+ Landing page + Relay selection +
+ +

+ 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). +

+ +

+ 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. +

+ +

+ 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.) +

+ +
+ ToC icon + Table of contents example +
+ + Typical use cases + + For e-books + +

+ The most common use for Alexandria is for e-books: both those 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. +

+ +

+ An example of a book is Jane Eyre +

+ +
+ Jane Eyre, by Charlotte Brontë +
+ + For scientific papers + +

+ 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. +

+ +

+ 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. +

+ +

+ Euler will also pioneer the HTTP-based (rather than websocket-based) + e-paper compatible version of the web app. +

+ +

+ An example of a research paper is Less Partnering, Less Children, or Both? +

+ +
+ Research paper +
+ + For documentation + +

+ Our own team uses Alexandria to document the app, to display our blog entries, as well as to store copies of our most interesting technical specifications. +

+ +
+ Documentation +
+ + For wiki pages + +

+ Alexandria now supports wiki pages (kind 30818), allowing for + collaborative knowledge bases and documentation. Wiki pages, such as this + one about the Sybil utility use the same + Asciidoc format as other publications but are specifically designed for interconnected, + evolving content. +

+ +

+ 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. +

+
diff --git a/src/styles/publications.css b/src/styles/publications.css index fe30740..17adefc 100644 --- a/src/styles/publications.css +++ b/src/styles/publications.css @@ -53,7 +53,7 @@ @apply p-3 text-wrap break-words; } - .note-leather .listingblock pre { + .publication-leather .listingblock pre { @apply overflow-x-auto; } @@ -62,24 +62,24 @@ @apply space-y-1 list-disc list-inside; } - .note-leather .olist ol { + .publication-leather .olist ol { @apply space-y-1 list-inside; } - .note-leather ol.arabic { + .publication-leather ol.arabic { @apply list-decimal; } - .note-leather ol.loweralpha { + .publication-leather ol.loweralpha { @apply list-lower-alpha; } - .note-leather ol.upperalpha { + .publication-leather ol.upperalpha { @apply list-upper-alpha; } - .note-leather li ol, - .note-leather li ul { + .publication-leather li ol, + .publication-leather li ul { @apply ps-5 my-2; } @@ -93,25 +93,25 @@ @apply my-2 font-thin text-lg; } - .note-leather li p { + .publication-leather li p { @apply inline; } /* blockquote; prose and poetry quotes */ - .note-leather .quoteblock, - .note-leather .verseblock { + .publication-leather .quoteblock, + .publication-leather .verseblock { @apply p-4 my-4 border-s-4 rounded border-primary-300 bg-primary-50 dark:border-primary-500 dark:bg-primary-700; } - .note-leather .verseblock pre.content { + .publication-leather .verseblock pre.content { @apply text-base font-sans; } - .note-leather .attribution { + .publication-leather .attribution { @apply mt-3 italic clear-both; } - .note-leather cite { + .publication-leather cite { @apply text-sm; } @@ -120,94 +120,98 @@ } /* admonition */ - .note-leather .admonitionblock .title { + .publication-leather .admonitionblock .title { @apply font-semibold; } - .note-leather .admonitionblock table { + .publication-leather .admonitionblock table { @apply w-full border-collapse; } - .note-leather .admonitionblock tr { - @apply flex flex-col; + .publication-leather .admonitionblock tr { + @apply flex flex-col border-none; } - .note-leather .admonitionblock p:has(code) { + .publication-leather .admonitionblock td { + @apply border-none; + } + + .publication-leather .admonitionblock p:has(code) { @apply my-3; } - .note-leather .admonitionblock { + .publication-leather .admonitionblock { @apply rounded overflow-hidden border; } - .note-leather .admonitionblock .icon, - .note-leather .admonitionblock .content { + .publication-leather .admonitionblock .icon, + .publication-leather .admonitionblock .content { @apply p-4; } - .note-leather .admonitionblock .content { + .publication-leather .admonitionblock .content { @apply pt-0; } - .note-leather .admonitionblock.tip { + .publication-leather .admonitionblock.tip { @apply rounded overflow-hidden border border-success-100 dark:border-success-800; } - .note-leather .admonitionblock.tip .icon, - .note-leather .admonitionblock.tip .content { + .publication-leather .admonitionblock.tip .icon, + .publication-leather .admonitionblock.tip .content { @apply bg-success-100 dark:bg-success-800; } - .note-leather .admonitionblock.note { + .publication-leather .admonitionblock.note { @apply rounded overflow-hidden border border-info-100 dark:border-info-700; } - .note-leather .admonitionblock.note .icon, - .note-leather .admonitionblock.note .content { + .publication-leather .admonitionblock.note .icon, + .publication-leather .admonitionblock.note .content { @apply bg-info-100 dark:bg-info-800; } - .note-leather .admonitionblock.important { + .publication-leather .admonitionblock.important { @apply rounded overflow-hidden border border-primary-200 dark:border-primary-700; } - .note-leather .admonitionblock.important .icon, - .note-leather .admonitionblock.important .content { + .publication-leather .admonitionblock.important .icon, + .publication-leather .admonitionblock.important .content { @apply bg-primary-200 dark:bg-primary-700; } - .note-leather .admonitionblock.caution { + .publication-leather .admonitionblock.caution { @apply rounded overflow-hidden border border-warning-200 dark:border-warning-700; } - .note-leather .admonitionblock.caution .icon, - .note-leather .admonitionblock.caution .content { + .publication-leather .admonitionblock.caution .icon, + .publication-leather .admonitionblock.caution .content { @apply bg-warning-200 dark:bg-warning-700; } - .note-leather .admonitionblock.warning { + .publication-leather .admonitionblock.warning { @apply rounded overflow-hidden border border-danger-200 dark:border-danger-800; } - .note-leather .admonitionblock.warning .icon, - .note-leather .admonitionblock.warning .content { + .publication-leather .admonitionblock.warning .icon, + .publication-leather .admonitionblock.warning .content { @apply bg-danger-200 dark:bg-danger-800; } /* listingblock, literalblock */ - .note-leather .listingblock, - .note-leather .literalblock { + .publication-leather .listingblock, + .publication-leather .literalblock { @apply p-4 rounded bg-highlight dark:bg-primary-700; } - .note-leather .sidebarblock .title, - .note-leather .listingblock .title, - .note-leather .literalblock .title { + .publication-leather .sidebarblock .title, + .publication-leather .listingblock .title, + .publication-leather .literalblock .title { @apply font-semibold mb-1; } /* sidebar */ - .note-leather .sidebarblock { + .publication-leather .sidebarblock { @apply p-4 rounded bg-info-100 dark:bg-info-800; }