ctargett / refguide-asciidoc-poc

Proof of concept of Solr Ref Guide converted to asciidoc format & using Asciidoctor for publishing
2 stars 4 forks source link

Stuff to look for post-conversion #27

Open ctargett opened 7 years ago

ctargett commented 7 years ago

Making a list of things to keep in mind after the conversion:

hossman commented 7 years ago

Things that ant check-links-and-anchors fails on (current snapshot) ...

check-links-and-anchors:
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/schema-api.html contains link w/ invalid syntax: http://<host>:<port>/solr/<collection_name>
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<host>:<port>/solr/<collection_name>
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/config-sets.html contains link w/ invalid syntax: http://<solr>/admin/cores?action=CREATE&name=mycore&instanceDir=path/to/instance&configSet=configset2
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<solr>/admin/cores?action=CREATE&name=mycore&instanceDir=path/to/instance&configSet=configset2
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/uploading-structured-data-store-data-with-the-data-import-handler.html contains link w/ invalid syntax: http://<host>:<port>/
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<host>:<port>/
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/uploading-structured-data-store-data-with-the-data-import-handler.html contains link w/ invalid syntax: http://<host>:<port>/
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<host>:<port>/
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/uploading-structured-data-store-data-with-the-data-import-handler.html contains link w/ invalid syntax: http://<host>:<port>/
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<host>:<port>/
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/uploading-structured-data-store-data-with-the-data-import-handler.html contains link w/ invalid syntax: http://<host>:<port>/solr/<collection_name>/command=reload-config
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<host>:<port>/solr/<collection_name>/command=reload-config
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/uploading-structured-data-store-data-with-the-data-import-handler.html contains link w/ invalid syntax: http://<host>:<port>/
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<host>:<port>/
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/cross-data-center-replication-cdcr-.html contains link w/ invalid syntax: http://<hostname>:<port>/solr/<collection>
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<hostname>:<port>/solr/<collection>
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/cross-data-center-replication-cdcr-.html contains link w/ invalid syntax: http://<hostname>:<port>/solr/<collection>
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<hostname>:<port>/solr/<collection>
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/configsets-api.html contains link w/ invalid syntax: http://<hostname>:<port>/solr
     [java]  ... java.net.URISyntaxException: Illegal character in authority at index 7: http://<hostname>:<port>/solr
     [java] file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/the-dismax-query-parser.html contains link w/ invalid syntax: http://localhost:8983/solr/techproducts/select?defType=dismax&q=video&bq=cat:electronics^5.0
     [java]  ... java.net.URISyntaxException: Illegal character in query at index 88: http://localhost:8983/solr/techproducts/select?defType=dismax&q=video&bq=cat:electronics^5.0
     [java] ID occurs multiple times: CrossDataCenterReplication_CDCR_-Configuration
     [java]  ... file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/cross-data-center-replication-cdcr-.html
     [java]  ... file:/home/hossman/lucid/refguide-asciidoc-poc/solr-ref-guide/build/html-site/cross-data-center-replication-cdcr-.html
     [java] Total of 12 problems found

Most of those are places where the markup is causing real <a href=...> tags to be created for bogus URLs (or URLs that workin a browser but break java because of unescaped characters) ... but the last one is a genuine instance of an anchor existing multiple times: both in the same source document actually.