update docs, correct wikilinks, and fix border styling closes Issue#215

README.md

@@ -7,7 +7,7 @@ For a thorough introduction, please refer to our [project documention](https://n
 
 ## Issues and Patches
 
-If you would like to suggest a feature or report a bug, or submit a patch for review, please use the [Nostr git interface](https://gitcitadel.com/r/naddr1qvzqqqrhnypzplfq3m5v3u5r0q9f255fdeyz8nyac6lagssx8zy4wugxjs8ajf7pqyt8wumn8ghj7ur4wfcxcetjv4kxz7fwvdhk6tcqpfqkcetcv9hxgunfvyamcf5z) on our homepage.
+If you would like to suggest a feature or report a bug, please use the [Alexandria Contact page](https://next-alexandria.gitcitadel.eu/contact).
 
 You can also contact us [on Nostr](https://njump.me/nprofile1qqsggm4l0xs23qfjwnkfwf6fqcs66s3lz637gaxhl4nwd2vtle8rnfqprfmhxue69uhhg6r9vehhyetnwshxummnw3erztnrdaks5zhueg), directly.
 

src/app.css

@@ -436,4 +436,17 @@
     display: flex;
     flex-direction: column;
   }
+
+  /* Input styles */
+  input[type="text"],
+  input[type="email"],
+  input[type="password"],
+  input[type="search"],
+  input[type="number"],
+  input[type="tel"],
+  input[type="url"],
+  textarea {
+    @apply bg-primary-0 dark:bg-primary-1000 text-gray-800 dark:text-gray-300 border-s-4 border-primary-200 rounded shadow-none px-4 py-2;
+    @apply focus:border-primary-400 dark:focus:border-primary-500;
+  }
 }

src/lib/utils/markup/MarkupInfo.md

@@ -2,9 +2,9 @@
 
 Alexandria supports multiple markup formats for different use cases. Below is a summary of the supported tags and features for each parser, as well as the formats used for publications and wikis.
 
-## Basic Markdown Parser
+## Basic Markup Parser
 
-The **basic markdown parser** supports:
+The **basic markup parser** follows the [Nostr best-practice guidelines](https://github.com/nostrability/nostrability/issues/146) and supports:
 
 - **Headers:**  
   - ATX-style: `# H1` through `###### H6`  
@@ -18,19 +18,19 @@ The **basic markdown parser** supports:
 - **Links:** `[text](url)`
 - **Images:** `![alt](url)`
 - **Hashtags:** `#hashtag`
-- **Nostr identifiers:** npub, nprofile, nevent, naddr, note, with or without `nostr:` prefix
+- **Nostr identifiers:** npub, nprofile, nevent, naddr, note, with or without `nostr:` prefix (note is deprecated)
-- **Emoji shortcodes:** `:smile:`
+- **Emoji shortcodes:** `:smile:` will render as 😄
 
-## Advanced Markdown Parser
+## Advanced Markup Parser
 
-The **advanced markdown parser** includes all features of the basic parser, plus:
+The **advanced markup parser** includes all features of the basic parser, plus:
 
 - **Inline code:** `` `code` ``
-- **Syntax highlighting:** for code blocks in over 100 languages
+- **Syntax highlighting:** for code blocks in many programming languages (from [highlight.js](https://highlightjs.org/))
 - **Tables:** Pipe-delimited tables with or without headers
-- **Footnotes:** `[^1]` and `[ ^1 ]: footnote text`
+- **Footnotes:** `[^1]` or `[^Smith]`, which should appear where the footnote shall be placed, and will be displayed as unique, consecutive numbers
-- **Wikilinks:** `[[Page Name]]` (NIP-54)
+- **Footnote References:** `[^1]: footnote text` or `[^Smith]: Smith, Adam. 1984 "The Wiggle Mysteries`, which will be listed in order, at the bottom of the event, with back-reference links to the footnote, and text footnote labels appended
-- **Better footnote rendering:** with backreferences and unique numbering
+- **Wikilinks:** `[[NIP-54]]` will render as a hyperlink and goes to [NIP-54](https://next-alexandria.gitcitadel.eu/publication?d=nip-54) (Will later go to our new disambiguation page.)
 
 ## Publications and Wikis
 
@@ -51,4 +51,5 @@ For more information on AsciiDoc, see the [AsciiDoc documentation](https://ascii
 **Note:**
 - The markdown parsers are primarily used for comments, issues, and other user-generated content.
 - Publications and wikis are rendered using AsciiDoc for maximum expressiveness and compatibility.
-- All URLs are sanitized to remove tracking parameters, and YouTube links are presented in a clean, privacy-friendly format. 
+- All URLs are sanitized to remove tracking parameters, and YouTube links are presented in a clean, privacy-friendly format.
+- [Here is a test markup file](/tests/integration/markupTestfile.md) that you can use to test out the parser and see how things should be formatted.

src/lib/utils/markup/basicMarkupParser.ts

@@ -142,9 +142,9 @@ function replaceWikilinks(text: string): string {
   return text.replace(/\[\[([^\]|]+)(?:\|([^\]]+))?\]\]/g, (_match, target, label) => {
     const normalized = normalizeDTag(target.trim());
     const display = (label || target).trim();
-    const url = `https://next-alexandria.gitcitadel.eu/publication?d=${normalized}`;
+    const url = `./publication?d=${normalized}`;
     // Output as a clickable <a> with the [[display]] format and matching link colors
-    return `<a class="wikilink text-primary-600 dark:text-primary-500 hover:underline" data-dtag="${normalized}" data-url="${url}" href="${url}">[[${display}]]</a>`;
+    return `<a class="wikilink text-primary-600 dark:text-primary-500 hover:underline" data-dtag="${normalized}" data-url="${url}" href="${url}">${display}</a>`;
   });
 }
 

src/routes/contact/+page.svelte

@@ -280,7 +280,7 @@
     </P>
 
     <P class="mb-3">
-    You can contact us on Nostr <A href="https://njump.me/nprofile1qqsggm4l0xs23qfjwnkfwf6fqcs66s3lz637gaxhl4nwd2vtle8rnfqprfmhxue69uhhg6r9vehhyetnwshxummnw3erztnrdaks5zhueg" title="npub1s3ht77dq4zqnya8vjun5jp3p44pr794ru36d0ltxu65chljw8xjqd975wz" target="_blank">npub1s3h…75wz</A> or you can view submitted issues on the <A href="https://gitcitadel.com/r/naddr1qvzqqqrhnypzquqjyy5zww7uq7hehemjt7juf0q0c9rgv6lv8r2yxcxuf0rvcx9eqy88wumn8ghj7mn0wvhxcmmv9uq3wamnwvaz7tmjv4kxz7fwdehhxarj9e3xzmny9uqsuamnwvaz7tmwdaejumr0dshsqzjpd3jhsctwv3exjcgtpg0n0/issues" target="_blank">Alexandria repo page.</A>
+    You can contact us on Nostr <A href="https://njump.me/nprofile1qqsggm4l0xs23qfjwnkfwf6fqcs66s3lz637gaxhl4nwd2vtle8rnfqprfmhxue69uhhg6r9vehhyetnwshxummnw3erztnrdaks5zhueg" title="npub1s3ht77dq4zqnya8vjun5jp3p44pr794ru36d0ltxu65chljw8xjqd975wz" target="_blank">GitCitadel</A> or you can view submitted issues on the <A href="https://gitcitadel.com/r/naddr1qvzqqqrhnypzquqjyy5zww7uq7hehemjt7juf0q0c9rgv6lv8r2yxcxuf0rvcx9eqy88wumn8ghj7mn0wvhxcmmv9uq3wamnwvaz7tmjv4kxz7fwdehhxarj9e3xzmny9uqsuamnwvaz7tmwdaejumr0dshsqzjpd3jhsctwv3exjcgtpg0n0/issues" target="_blank">Alexandria repo page.</A>
     </P>
     
     <Heading tag='h2' class='h-leather mt-4 mb-2'>Submit an issue</Heading>
@@ -329,7 +329,7 @@
                 <div class="absolute inset-0 overflow-hidden">
                   <Textarea
                     id="content"
-                    class="w-full h-full resize-none border-0 focus:ring-0 bg-white dark:bg-gray-800 p-4 description-textarea rounded-b-lg rounded-t-none"
+                    class="w-full h-full resize-none bg-primary-0 dark:bg-primary-1000 text-gray-800 dark:text-gray-300 border-s-4 border-primary-200 rounded-b-lg rounded-t-none shadow-none px-4 py-2 focus:border-primary-400 dark:focus:border-primary-500"
                     bind:value={content}
                     required
                     placeholder="Describe your issue in detail...

tests/integration/markupTestfile.md

@@ -24,6 +24,7 @@ npub1l5sga6xg72phsz5422ykujprejwud075ggrr3z2hwyrfgr7eylqstegx9z wrote this. That
 > lines of
 > important information
 > with a second[^2] footnote.
+[^2]: This is a "Test" of a longer footnote-reference, placed inline, including some punctuation. 1984.
 
 This is a youtube link 
 https://www.youtube.com/watch?v=9aqVxNCpx9s
@@ -240,5 +241,4 @@ Here is a table without a header row:
 | just | pipes |
 
 [^1]: this is a footnote
-[^2]: so is this
 [^some reference text]: this is a footnote that isn't a number