Merge pull request #402 from dynamsoft-docs/preview

Preview

Author: Dynamsoft-Henry

_config.yml

@@ -1,4 +1,4 @@
-repositoryUrlJS: https://github.com/dynamsoft-docs/barcode-reader-docs-js/blob/main
+repositoryUrl: https://github.com/dynamsoft-docs/barcode-reader-docs-js/blob/main
 repository: dynamsoft-docs/barcode-reader-docs-js
 docFullPath: https://www.dynamsoft.com/barcode-reader/docs/web/
 firstLevelUrl: /barcode-reader/docs/web
@@ -65,63 +65,18 @@ defaults:
       path: "programming-old"
     values:
       ignore: true
-  - scope:
-      path: ""
-    values:
-      category: "original-repo"
-      edition: "algorithm"
+      docRootName: "Barcode Reader JavaScript Edition" 
+      docHomePage: "/barcode-reader/docs/web/programming/javascript/"
   - scope:
       path: "programming/javascript"
     values:
-      category: "js-repo"
-      edition: "js"
-  - scope:
-      path: "mobile/programming/android"
-    values:
-      category: "mobile-repo"
-      edition: "mobile"
+      docRootName: "Barcode Reader JavaScript Edition" 
+      docHomePage: "/barcode-reader/docs/web/programming/javascript/"
   - scope:
       path: "programming-old/javascript"
     values:
-      category: "js-repo"
-      edition: "js"
       docRootName: "Barcode Reader JavaScript Edition" 
       docHomePage: "/barcode-reader/docs/web/programming/javascript/"
-  - scope:
-      path: "mobile/programming/objectivec-swift"
-    values:
-      category: "mobile-repo"
-      edition: "mobile"
-  - scope:
-      path: "server/programming/c"
-    values:
-      category: "original-repo"
-      edition: "desktop"
-  - scope:
-      path: "server/programming/cplusplus"
-    values:
-      category: "original-repo"
-      edition: "desktop"
-  - scope:
-      path: "server/programming/c-cplusplus"
-    values:
-      category: "original-repo"
-      edition: "desktop"
-  - scope:
-      path: "server/programming/dotnet"
-    values:
-      category: "original-repo"
-      edition: "desktop"
-  - scope:
-      path: "server/programming/python"
-    values:
-      category: "original-repo"
-      edition: "desktop"
-  - scope:
-      path: "server/programming/java"
-    values:
-      category: "original-repo"
-      edition: "desktop"
   - scope:
       path: ""
     values:

_includes/dbrNav.html

@@ -12,6 +12,11 @@
     }
 </style>
 
+{%- assign docHomePage = site.docHomePage -%}
+  {%- if page.docHomePage -%}
+      {%- assign docHomePage = page.docHomePage -%}
+  {%- endif -%}
+
 <div id="BarcodeReader" class="main">
     <div id="BarcodeReaderMenu" class="productMenu">
         <div class="container pcProductMenu">
@@ -38,7 +43,7 @@
                             <span class="showMenuMore textUpperCase">Dev Center  <i class="icon-orange-angle"></i></span>
                             <ul class="ct-more" style="display: none">
                                 <i class="icon-orange-angle"></i>
-                                <li class="item"><a href="https://www.dynamsoft.com/barcode-reader/docs/core/introduction/">Documentation</a></li>
+                                <li class="item"><a href="{{docHomePage}}">Documentation</a></li>
                                 <li class="item"><a href="https://www.dynamsoft.com/barcode-reader/resources/code-gallery/">Code Gallery</a></li>
                                 <li class="item"><a href="https://www.dynamsoft.com/barcode-reader/docs/core/release-notes/">Release Notes</a></li>
                                 <li class="item"><a class="all-resources f16 mt20 orangeLink" href="https://www.dynamsoft.com/barcode-reader/resources/">See All resources ></a></li>
@@ -81,7 +86,7 @@
                             <li class="item resources">
                                 <span class="showMenuMore textUpperCase">Dev Center  <i class="icon-orange-angle"></i></span>
                                 <ul class="ct-more" style="display: none">
-                                    <li class="item"><a href="https://www.dynamsoft.com/barcode-reader/docs/core/introduction/">Documentation</a></li>
+                                    <li class="item"><a href="{{docHomePage}}">Documentation</a></li>
                                     <li class="item"><a href="https://www.dynamsoft.com/barcode-reader/resources/code-gallery/">Code Gallery</a></li>
                                     <li class="item"><a href="https://www.dynamsoft.com/barcode-reader/docs/core/release-notes/">Release Notes</a></li>
                                     <li class="item"><a class="all-resources f16 mt20 orangeLink" href="https://www.dynamsoft.com/barcode-reader/resources/">See All resources ></a></li>

_includes/sidelist-programming/programming-javascript.html

@@ -1659,6 +1659,16 @@
         barcodes via video in iOS 16.7 or 17?</a
       >
     </li>
+    <li>
+      <a href="{{ site.js }}faq/remove-duplicates.html"
+        >How to Reduce Duplicate Scans and Optimize Scan Usage?</a
+      >
+    </li>
+    <li>
+      <a href="{{ site.js }}faq/webcam-support-dense.html"
+        >Why isn't my webcam reading the barcode on my driver's license or ID card?</a
+      >
+    </li>
   </ul>
 </li>
 <li lang="javascript"><a href="{{ site.license_activation }}index.html" class="otherLinkColour">License Initialization</a></li>

programming/javascript/faq/index.md

@@ -82,3 +82,5 @@ noTitleIndex: true
 36. [How do I resolve the issue of the Barcode Reader not recognizing any barcodes via video in iOS 16.7 or 17?](ios-17-readability.html)
 
 37. [How to Reduce Duplicate Scans and Optimize Scan Usage?](remove-duplicates.html)
+
+38. [Why isn't my webcam reading the barcode on my driver's license or ID card?](webcam-support-dense.md)

programming/javascript/faq/webcam-support-dense.md

@@ -0,0 +1,23 @@
+---
+layout: default-layout
+title: Why isn't my webcam reading the barcode on my driver's license or ID card?
+keywords: Dynamsoft Barcode Reader, FAQ, tech basic, webcam, driver license, ID
+description: Why isn't my webcam reading the barcode on my driver's license or ID card?
+needAutoGenerateSidebar: false
+---
+
+# Why isn't my webcam reading the barcode on my driver's license or ID card?
+
+[<< Back to FAQ index](index.md)
+
+When you attempt to read the barcode from a driver's license or an ID card using your built-in laptop webcam and our [online demo](https://demo.dynamsoft.com/barcode-reader-js/), you will notice that the barcode does not get read almost all of the time. That is due to several factors - the lack in camera quality combined with the high density of PDF417 barcodes.
+
+The barcode that is present on the back of driver licenses and ID cards is usually a [PDF417 barcode](https://www.dynamsoft.com/barcode-reader/barcode-types/pdf417/), one of the most common high-density 2D barcodes. Due to its high density, PDF417s usually require a camera that supports a minimum resolution of 720p and, more importantly, has the ability to focus, whether it is autofocus or manual focus.
+
+Most built-in laptop webcams these days meet the minimum required resolution of 720p - but they almost always lack the ability to focus. The ability to focus is very important as it helps pass a clear image/frame of the PDF417 code to the DBR library, making it actually readable.
+
+This problem is never really encountered on mobile as most modern mobile phones these days have high quality cameras that have the ability to autofocus, so that is never really a worry with mobile phones.
+
+Therefore, if you are required to use laptops to read barcodes from driver licenses in your use case, please keep this in mind. We recommend avoiding using laptop webcams as the camera input for such use cases. If you need to use laptops, then we recommend purchasing an external webcam that meets the minimum resolution (1080p is the recommended resolution, but 720p is the minimum) but more importantly, has the ability to focus. If your built-in laptop webcam does indeed have the ability top focus and you are still 
+
+If your built-in laptop webcam does indeed have the ability to focus and you are still struggling to read the PDF417 barcode, please let us know as we could potentially use some of the [Camera Enhancer API]({{site.dce_js_api}}index.html) to hone the focus of the camera to be suited for this use case. If you have any questions on this matter, do not hesitate to [contact us](https://www.dynamsoft.com/contact/).