Merge pull request #971 from dynamsoft-docs/preview

llms.txt and minor update

Author: Ellie-dynamsoft

_articles/extended-usage/dynamsoft-service-configuration.md

@@ -15,7 +15,7 @@ The Dynamic Web TWAIN Service is the core piece of Dynamic Web TWAIN. It handles
 
 ## Installation of Dynamic Web TWAIN Service
 
-On a desktop, when a new user accesses a web page using Dynamic Web TWAIN SDK for the first time, he will be prompted to install the Dynamic Web TWAIN Service. This is a built-in behavior of the library. The prompt will display the download link. Once the installer is downloaded, the installation process will take just a few seconds.
+On a desktop, when new users access a web page using Dynamic Web TWAIN SDK for the first time, they will be prompted to install the Dynamic Web TWAIN Service. This is a built-in behavior of the library. The prompt will display the download link. Once the installer is downloaded, the installation process will take just a few seconds.
 
 The prompt comes up when you try to [create a WebTwain instance](/_articles/extended-usage/advanced-initialization.md#instantiating-webtwain-without-onwebtwainready).
 
@@ -122,10 +122,11 @@ When a request comes from a different origin, a CORS error message will be displ
 
 The service provides a web page to know its status and make basic configurations. You can access it through <http://127.0.0.1:18625>.
 
-For security reasons, the web setup is disabled by default. You can add the following line to `DSConfiguration.ini` to enable it.
+For security reasons, the web setup is disabled by default. You modify the following line in `DSConfiguration.ini` to enable it. If you cannot find the line, you can add it manually.
 
-```
-EnableWebSetup=TRUE
+```diff
+- EnableWebSetup=FALSE
++ EnableWebSetup=TRUE
 ```
 
 Screenshots:

_articles/extended-usage/pdf-compression.md

@@ -0,0 +1,12 @@
+module Jekyll
+  module HtmlDecodeFilter
+    require 'cgi'
+    
+    def html_decode(input)
+      return '' if input.nil?
+      CGI.unescapeHTML(input.to_s)
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::HtmlDecodeFilter)

_plugins/html_decode_filter.rb

@@ -0,0 +1,34 @@
+# _plugins/raw_content_for_collections.rb
+module Jekyll
+  class RawContentForCollections < Generator
+    safe true
+    priority :low
+
+    def generate(site)
+      site.collections.each do |label, collection|
+        next unless label == 'articles'
+        collection.docs.each do |doc|
+          source_path = File.join(site.source, doc.relative_path)
+          
+          if File.exist?(source_path)
+            raw_file_content = File.read(source_path, encoding: 'UTF-8')
+            content_without_front_matter = remove_front_matter(raw_file_content)
+            doc.data['raw_content'] = content_without_front_matter
+          end
+        end
+      end
+      
+    end
+
+    private
+
+    def remove_front_matter(content)
+      if content =~ /\A---\s*\n.*?\n---\s*\n+/m
+        result = content.sub(/\A---\s*\n.*?\n---\s*\n+/m, '')
+        return result
+      else
+        return content
+      end
+    end
+  end
+end

_plugins/raw_content_for_collections.rb

@@ -0,0 +1,12 @@
+module Jekyll
+  module CustomFilters
+    def render_article_links(content)
+      content = content.gsub(%r{/_articles/(.*?)\.md}, 
+                           'https://www.dynamsoft.com/web-twain/docs/\1.html')
+      
+      return content
+    end
+  end
+end
+
+Liquid::Template.register_filter(Jekyll::CustomFilters)

_plugins/render_links.rb

@@ -9,9 +9,9 @@ sitemap: false
     {
       "title": {{ article.title | jsonify }},
       "url": "https://www.dynamsoft.com{{ article.url | relative_url }}",
-      "content": {{ article.content | strip_html | jsonify }},
+      "content": {{ article.raw_content | render_article_links | jsonify }},
       "breadcrumb": {{ article.breadcrumbText | default: article.title | jsonify }}
     }{% unless forloop.last %},{% endunless %}
     {% endfor %}
   ]
-}
+}

api.json

@@ -8,7 +8,7 @@ sitemap: false
     {
       "title": {{ article.title | jsonify }},
       "url": "https://www.dynamsoft.com{{ article.url | relative_url }}",
-      "content": {{ article.content | strip_html | jsonify }},
+      "content": {{ article.raw_content | render_article_links | jsonify }},
       "breadcrumb": {{ article.breadcrumbText | default: article.title | jsonify }}
     }{% unless forloop.last %},{% endunless %}
     {% endfor %}

articles.json

@@ -0,0 +1,17 @@
+---
+layout: null
+sitemap: false
+---
+{% for article in site.articles %}<page>
+---
+title: {{article.title}}
+description: {{article.description}}
+source_url:
+  html: https://www.dynamsoft.com{{ article.url | relative_url }}
+  md: {{ site.repositoryUrl }}/{{article.path}}
+---
+{{ article.raw_content }}
+</page>
+
+{% endfor %}
+

llms-full.txt

@@ -0,0 +1,15 @@
+---
+layout: null
+sitemap: false
+---
+
+# Dynamic Web TWAIN Docs
+
+## Docs
+
+{% for article in site.articles %}- [{{article.title}}](https://www.dynamsoft.com{{ article.url | relative_url }}): {{ article.description }}
+{% endfor %}
+
+## Samples
+
+- [Samples](https://github.com/Dynamsoft/web-twain-codelab/): Samples of Dynamic Web TWAIN