DocC documentation can't be rendered with Apache on CentOS 7

Question

wonconn OP

Created Nov ’21

Replies 4

Boosts 0

Views 2.3k

Participants 2

I downloaded the sample code project 'SlothCreator' from here then exported a SlothCreator.doccarchive file.

I placed the SlothCreator.doccarchive in /var/www/html/. I use Apache web server on CentOS 7.

My .htaccess file is as follows.

# Enable custom routing.
RewriteEngine On

# Route documentation and tutorial pages.
RewriteRule ^(documentation|tutorials)\/.*$ SlothCreator.doccarchive/index.html [L]

# Route files and data for the documentation archive.
RewriteRule ^(css|js|data|images|downloads|favicon\.ico|favicon\.svg|img|theme-settings\.json|videos)\/.$ SlothCreator.doccarchive/$0 [L]

# If the file path doesn't exist in the website's root ...
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d

# ... route the request to that file path with the documentation archive.
RewriteRule .* SlothCreator.doccarchive/$0 [L]

I confirmed that the RewriteEngine works well.

I try the following urls then see error message "An unknown error occurred." or "The page you’re looking for can’t be found."

http://localhost/documentation/SlothCreator
=> "An unknown error occurred."

http://localhost/SlothCreator.doccarchive/index.html
=> "The page you’re looking for can’t be found."

Can I know what the problem is?

Doesn't it work with CentOS?

Answered by wonconn in 698609022

I found what is the cause. The problem is Case Sensitive in my cent os.

"http://localhost/documentation/SlothCreator" requests /data/documentation/SlothCreator.json, but the file name is /data/documentation/slothcreator.json.

So I added follows to the .htaccess.

RewriteRule /data/documentation/SlothCreator.json /data/documentation/slothcreator.json

then It works well.

Boost

Answer 1

wonconn OP

Nov ’21

Appache access log:

"GET /documentation/SlothCreator HTTP/1.1" 200 3789 "-" "GET /css/index.7bb6526a.css HTTP/1.1" 200 25432 "http: "GET /js/chunk-vendors.779cfe0d.js HTTP/1.1" 200 93127 "GET /js/index.2b1836ed.js HTTP/1.1" 200 20015 "http:// "GET /css/documentation-topic.9689e104.css HTTP/1.1" 200 468 "GET /css/documentation-topic~topic~tutorials-overview.83d60 "GET /css/topic.71a5a916.css HTTP/1.1" 200 58203 "http:// "GET /css/tutorials-overview.7d1da3df.css HTTP/1.1" 200 1743 "GET /js/chunk-2d0d3105.459bf725.js HTTP/1.1" 200 6923 "http "GET /js/documentation-topic.d0b0a554.js HTTP/1.1" 200 83535 "GET /js/documentation-topic~topic~tutorials-overview.e72431 "GET /js/highlight-js-bash.85a55401.js HTTP/1.1" 200 2175 "h "GET /js/highlight-js-c.99b899e6.js HTTP/1.1" 200 3991 "http "GET /js/highlight-js-cpp.46268241.js HTTP/1.1" 200 5807 "ht "GET /js/highlight-js-css.c12e29c1.js HTTP/1.1" 200 7055 "ht "GET /css/documentation-topic~topic~tutorials-overview.83d60 "GET /theme-settings.json HTTP/1.1" 200 1160 "http:// "GET /css/documentation-topic.9689e104.css HTTP/1.1" 200 468 "GET /js/documentation-topic~topic~tutorials-overview.e72431 "GET /js/documentation-topic.d0b0a554.js HTTP/1.1" 200 83535 "GET /js/highlight-js-custom-markdown.fb3d4662.js HTTP/1.1" "GET /js/highlight-js-custom-swift.b1f7a896.js HTTP/1.1" 200 "GET /js/highlight-js-diff.672514df.js HTTP/1.1" 200 841 "ht "GET /js/highlight-js-http.ec39e120.js HTTP/1.1" 200 998 "ht "GET /js/highlight-js-java.a814d7f9.js HTTP/1.1" 200 2526 "h "GET /js/highlight-js-json.471128d2.js HTTP/1.1" 200 452 "ht "GET /js/highlight-js-javascript.4d4a362d.js HTTP/1.1" 200 5 "GET /js/highlight-js-llvm.ddaa176e.js HTTP/1.1" 200 2749 "h "GET /js/highlight-js-markdown.451c845b.js HTTP/1.1" 200 212 "GET /js/highlight-js-objectivec.bcdf5156.js HTTP/1.1" 200 2 "GET /js/highlight-js-python.b6226703.js HTTP/1.1" 200 4373 "GET /js/highlight-js-php.cc8d6c27.js HTTP/1.1" 200 4153 "ht "GET /js/highlight-js-perl.b3c5d3f2.js HTTP/1.1" 200 4663 "h "GET /js/highlight-js-ruby.fb547e8d.js HTTP/1.1" 200 3597 "h "GET /js/highlight-js-scss.33a3a3f7.js HTTP/1.1" 200 7912 "h "GET /js/highlight-js-swift.0e0d0e76.js HTTP/1.1" 200 7465 " "GET /js/highlight-js-xml.784eb41b.js HTTP/1.1" 200 2236 "ht "GET /js/topic.cd2c44f5.js HTTP/1.1" 200 84134 "http:// "GET /js/tutorials-overview.db178ab9.js HTTP/1.1" 200 31964 "GET /data/documentation/SlothCreator.json HTTP/1.1" 500 527

0

Answer 2

wonconn OP

Nov ’21

CentOS: /data/documentation/SlothCreator.json HTTP/1.1" 500 527 ||| Mac: /data/documentation/SlothCreator.json HTTP/1.1" 200 12927

0

Answer 3

Documentation Engineer OP

Apple

Nov ’21

I am not aware of any known issues with supporting CentOS specifically. The second 404 error should be expected since that is not a valid URL. For the first “unknown error”, it might be helpful to check the Apache “error_log” file, perhaps interactively watching it with tail -f to see if it prints out any errors when you load that first URL and see that error message on the browser. That error usually indicates that something went wrong on the server and perhaps there is something not configured exactly right.

0

Answer 4

wonconn OP

Dec ’21

Accepted Answer

I found what is the cause. The problem is Case Sensitive in my cent os.

"http://localhost/documentation/SlothCreator" requests /data/documentation/SlothCreator.json, but the file name is /data/documentation/slothcreator.json.

So I added follows to the .htaccess.

RewriteRule /data/documentation/SlothCreator.json /data/documentation/slothcreator.json

then It works well.

2