Add TOC to FAQ

Author: crandmck

docs/trustmark-faq.mdx

@@ -0,0 +1,52 @@
+---
+id: tm-faq
+title: TrustMark FAQ
+hide_table_of_contents: true
+---
+
+- [General Usage and Adoption](#general-usage-and-adoption)
+  - [What is TrustMark?](#what-is-trustmark)
+  - [How does TrustMark compare to traditional visible watermarks?](#how-does-trustmark-compare-to-traditional-visible-watermarks)
+  - [What is this software?](#what-is-this-software)
+  - [Can I integrate TrustMark into my own application?](#can-i-integrate-trustmark-into-my-own-application)
+  - [Can I use TrustMark in commercial projects?](#can-i-use-trustmark-in-commercial-projects)
+  - [Why would I want to make an image identifiable using TrustMark?](#why-would-i-want-to-make-an-image-identifiable-using-trustmark)
+  - [Can TrustMark be embedded in any images, including those generated by AI?](#can-trustmark-be-embedded-in-any-images-including-those-generated-by-ai)
+  - [How does TrustMark align with provenance standards such as the C2PA?](#how-does-trustmark-align-with-provenance-standards-such-as-the-c2pa)
+  - [Does TrustMark alter metadata or EXIF information?](#does-trustmark-alter-metadata-or-exif-information)
+- [Technical Details](#technical-details)
+  - [Does TrustMark support my image format?](#does-trustmark-support-my-image-format)
+  - [Does TrustMark work on grayscale images?](#does-trustmark-work-on-grayscale-images)
+  - [How fast is TrustMark?](#how-fast-is-trustmark)
+  - [What are the image resolution limits of TrustMark?](#what-are-the-image-resolution-limits-of-trustmark)
+  - [How robust is TrustMark?](#how-robust-is-trustmark)
+  - [Can I print TrustMark?](#can-i-print-trustmark)
+  - [Can TrustMark be embedded in vector graphics?](#can-trustmark-be-embedded-in-vector-graphics)
+  - [What dataset was TrustMark trained on?](#what-dataset-was-trustmark-trained-on)
+  - [What happens if I apply TrustMark to an already watermarked image?](#what-happens-if-i-apply-trustmark-to-an-already-watermarked-image)
+  - [How does TrustMark compare to State of the Art Watermarking approaches](#how-does-trustmark-compare-to-state-of-the-art-watermarking-approaches)
+  - [Can TrustMark co-exist with other watermarks?](#can-trustmark-co-exist-with-other-watermarks)
+- [Configuration](#configuration)
+  - [Which variant of TrustMark should I use?](#which-variant-of-trustmark-should-i-use)
+  - [How can I trade off between robustness and capacity?](#how-can-i-trade-off-between-robustness-and-capacity)
+  - [How can I trade off between robustness and quality?](#how-can-i-trade-off-between-robustness-and-quality)
+  - [Can I control where the watermark is embedded in an image?](#can-i-control-where-the-watermark-is-embedded-in-an-image)
+  - [Does TrustMark affect the file size of an image?](#does-trustmark-affect-the-file-size-of-an-image)
+- [Security and Privacy](#security-and-privacy)
+  - [Can TrustMark be removed?](#can-trustmark-be-removed)
+  - [Can TrustMark be used to track users or infringe on privacy?](#can-trustmark-be-used-to-track-users-or-infringe-on-privacy)
+  - [Can TrustMark be used to secretly mark images without user consent?](#can-trustmark-be-used-to-secretly-mark-images-without-user-consent)
+  - [Is TrustMark steganographic watermarking?](#is-trustmark-steganographic-watermarking)
+  - [Why release removal code?](#why-release-removal-code)
+  - [Does TrustMark interfere with other AI or image processing tasks like object detection?](#does-trustmark-interfere-with-other-ai-or-image-processing-tasks-like-object-detection)
+  - [Can TrustMark be used to detect image manipulation?](#can-trustmark-be-used-to-detect-image-manipulation)
+  - [Can TrustMark be transferred from one image to another?](#can-trustmark-be-transferred-from-one-image-to-another)
+  - [What stops someone from spoofing a TrustMark?](#what-stops-someone-from-spoofing-a-trustmark)
+- [Future Developments](#future-developments)
+  - [Will TrustMark support other media types like video?](#will-trustmark-support-other-media-types-like-video)
+  - [Is TrustMark compatible with blockchain technology?](#is-trustmark-compatible-with-blockchain-technology)
+  - [Can TrustMark be used for NFT provenance?](#can-trustmark-be-used-for-nft-provenance)
+
+import Faq from './trustmark/faq.md';
+
+<Faq name="faq" />

docs/trustmark-oveview.md renamed to docs/trustmark-intro.md

@@ -1,5 +1,5 @@
 ---
-id: trustmark-overview
+id: trustmark-intro
 title: TrustMark watermarking
 ---
 
@@ -10,7 +10,7 @@ TrustMark is an open-source universal watermarking system for images that:
 - Has implementations in both Python (using PyTorch) and JavaScript (using ONNX).
 
 :::info
-For full technical details and help getting started with TrustMark, see [TrustMark - Quick start](trustmark/readme.md#quick-start).
+For full technical details and help getting started with TrustMark, see [TrustMark - Overview](trustmark/readme.md).
 :::
 
 ## Variants
@@ -24,12 +24,12 @@ Images encoded with one variant cannot be decoded with another variant, so you n
 - **Variant C (Compact)** - Use if you need to minimize model size and can live with slightly lower visual quality. PSNR is 38-39 dB.
 
 The general recommendation is to use either:
-- Variant Q for most use cases
-- Variant P when visual quality is paramount
+- Variant Q for most use cases.
+- Variant P when visual quality is paramount.
 
-### About PSNR
+## About PSNR
 
-PSNR (Peak Signal-to-Noise Ratio) is a technical metric used to measure image quality, particularly when comparing an original image to a modified version (in this case, the watermarked image). PSNR is measured in decibels (dB), and higher values indicate better image quality:
+PSNR (Peak Signal-to-Noise Ratio) is a measure of image quality when comparing an original image to the watermarked image. PSNR is measured in decibels (dB), with higher values indicating better quality:
 - Values around 45+ dB typically indicate very good quality.
 - Values around 40 dB indicate acceptable quality.
 - Values below 30 dB indicate poor quality, unacceptable for most uses.

sidebars.js

@@ -272,7 +272,7 @@ const sidebars = {
         {
           type: 'category',
           label: 'TrustMark watermarking',
-          link: { type: 'doc', id: 'trustmark-overview' },
+          link: { type: 'doc', id: 'trustmark-intro' },
           collapsed: true,
           items: [
             {
@@ -287,7 +287,7 @@ const sidebars = {
             },
             {
               type: 'doc',
-              id: 'trustmark/faq',
+              id: 'tm-faq',
               label: 'FAQ',
             },
             {

src/css/custom.css

@@ -418,3 +418,9 @@ body:not(.is-scrolling) .navbar {
 .trust-table th:nth-child(1) {
   width: 170px;
 }
+
+/* For content to be displayed only in GitHub. Typically this will be used in imported markdown files. */
+
+.github-only {
+  display: none;
+}