Fix AsciiDoc xref links and restructure commands to flat /references/ directory

.lycheeignore

@@ -38,7 +38,7 @@ file:///path/to/
 
 # GitHub URLs for this repository (will be checked differently)
 # Exclude to avoid checking during development
-# https://github.com/metanorma/postscript-guide
+# https://github.com/claricle/postscript-guide
 
 # Template/placeholder patterns in examples
 PLACEHOLDER
@@ -51,3 +51,10 @@ FIXME
 
 # PostScript.org site unavailable
 https://www.postscript.org/
+
+# Schema.org may be temporarily unavailable
+https://schema.org/
+
+# Internal files
+file:///home/runner/work/postscript-guide/postscript-guide/LICENSE
+file:///home/runner/work/postscript-guide/postscript-guide/docs/LINK_CHECKING.md

README.adoc

@@ -1,7 +1,7 @@
 = PostScript Language Guide
 
-image:https://img.shields.io/github/license/metanorma/postscript-guide.svg[License]
-image:https://img.shields.io/github/actions/workflow/status/metanorma/postscript-guide/pages.yml?branch=main[Build Status]
+image:https://img.shields.io/github/license/claricle/postscript-guide.svg[License]
+image:https://img.shields.io/github/actions/workflow/status/claricle/postscript-guide/pages.yml?branch=main[Build Status]
 
 == Purpose
 
@@ -15,7 +15,7 @@ accessible, well-organized resource for developers, designers, and anyone
 working with PostScript.
 
 The documentation is deployed at:
-https://metanorma.github.io/postscript-guide/
+https://claricle.github.io/postscript-guide/
 
 == Features
 
@@ -46,7 +46,7 @@ Clone the repository:
 
 [source,bash]
 ----
-git clone https://github.com/metanorma/postscript-guide.git
+git clone https://github.com/claricle/postscript-guide.git
 cd postscript-guide
 ----
 
@@ -219,7 +219,7 @@ Reference Guide.
 [[reporting-issues]]
 === Reporting issues
 
-* Use the https://github.com/metanorma/postscript-guide/issues[GitHub Issues]
+* Use the https://github.com/claricle/postscript-guide/issues[GitHub Issues]
   page
 * Provide clear descriptions of errors or missing content
 * Include specific examples when possible
@@ -289,8 +289,8 @@ for details.
 [[support]]
 == Support
 
-Documentation:: https://metanorma.github.io/postscript-guide/
+Documentation:: https://claricle.github.io/postscript-guide/
 
-Issues:: https://github.com/metanorma/postscript-guide/issues
+Issues:: https://github.com/claricle/postscript-guide/issues
 
-Discussions:: https://github.com/metanorma/postscript-guide/discussions
+Discussions:: https://github.com/claricle/postscript-guide/discussions

_config.yml

@@ -1,18 +1,18 @@
 title: "PostScript Language Guide"
 description: "Comprehensive documentation for the PostScript programming language, covering operators, syntax, and practical usage examples"
 # baseurl: "/postscript-guide"
-url: "https://metanorma.github.io"
+url: "https://claricle.github.io"
 
 # Repository
-repository: metanorma/postscript-guide
+repository: claricle/postscript-guide
 
 # Theme configuration
 theme: just-the-docs
 color_scheme: light
 
-# Logo and favicon (optional, can be added later)
-# logo: "/assets/images/logo.png"
-# favicon_ico: "/assets/images/favicon.ico"
+# Logo and favicon
+logo: "/docs/assets/images/logo.svg"
+favicon_ico: "/docs/assets/images/favicon.ico"
 
 # AsciiDoc support
 asciidoc: {}
@@ -47,9 +47,9 @@ nav_fold: true
 # External links
 aux_links:
   "Source":
-    - "https://github.com/metanorma/postscript-guide"
+    - "https://github.com/claricle/postscript-guide"
   "Report Issues":
-    - "https://github.com/metanorma/postscript-guide/issues"
+    - "https://github.com/claricle/postscript-guide/issues"
   "Adobe PostScript Language Reference Manual":
     - "https://www.adobe.com/jp/print/postscript/pdfs/PLRM.pdf"
 
@@ -63,7 +63,7 @@ back_to_top_text: "Back to top"
 heading_anchors: true
 
 # Footer
-footer_content: "Copyright &copy; 2025 Metanorma. PostScript is a trademark of Adobe. Distributed under the <a href=\"https://github.com/metanorma/postscript-guide/blob/main/LICENSE\">MIT License</a>."
+footer_content: "Copyright &copy; 2025 Ribose. PostScript is a trademark of Adobe. Distributed under the <a href=\"https://github.com/claricle/postscript-guide/blob/main/LICENSE\">MIT License</a>."
 
 # Collections
 collections:

docs/_includes/head_custom.html

@@ -0,0 +1,5 @@
+<!-- Favicon links for better browser support -->
+<link rel="icon" type="image/png" sizes="32x32" href="{{ '/assets/images/favicon-32x32.png' | relative_url }}">
+<link rel="icon" type="image/png" sizes="16x16" href="{{ '/assets/images/favicon-16x16.png' | relative_url }}">
+<link rel="apple-touch-icon" sizes="180x180" href="{{ '/assets/images/apple-touch-icon.png' | relative_url }}">
+<link rel="icon" type="image/svg+xml" href="{{ '/assets/images/logo.svg' | relative_url }}">