Skip to content
Mathieu Aubin edited this page Sep 16, 2017 · 15 revisions

Frequently Asked Questions

Why am I getting a 403 error when visiting the _public folder?

All files and folders inside _public are remapped, hence you should not point your browser to _public, but to its parent folder.

Why am I getting a 404 error when clicking a link?

You will likely have to specify RewriteBase. Open the .htaccess file in the root-dir, then uncomment the setting and put the directory name there.

If you run Bootstrap Listr in /html/files, this should be RewriteBase files/.

Why am I getting 404 errors on subfolders with nginx?

The .htaccess file is not supported with nginx. Here is a working nginx configuration:

server {
    root /var/www/books;

    location / {
        index index.php;
        # Below is the .htaccess equivalence
        if (!-e $request_filename) {
           rewrite ^(.+)$ /index.php?path=$1;
        }
    }

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_pass unix:/var/run/php-fastcgi/php.sock;
        fastcgi_index index.php;
        fastcgi_param HTTP_PROXY ""; # Mitigates https://httpoxy.org vulnerability
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

How can I enable/disable the viewer modal for certain file types?

The configuration for the viewer modal can be adjusted in config.json. There are currently 9 categories for different kinds of modals to choose from.

How can I add syntax highlighting for an unsupported language?

If the language is supported by highlight.js, you can add it to the highlight.languages key in config.json. Make sure the language is also in the viewer.source key. Run the build task for the changes to take effect.

Why are there no Glyphicons displayed when using Bootswatch?

This likely happens when you are serving assets a CDN. Only the default Bootstrap theme is hosted with Glyphicons, for all other themes you must either server assets locally or use a different icon set.

Why are CDN-hosted assets not protocol-relative URLs?

“Now that SSL is encouraged for everyone and doesn’t have performance concerns, this technique is now an anti-pattern. If the asset you need is available on SSL, then always use the https:// asset.” —Paul Irish (via)

Still have doubts? Try it YOURSELF and experience the difference in your own browser.

How can I hide the counter in Bootstrap v2.3?

Since the counter is pure CSS, you will have to add a rule to hide it:

.table tr::before {
    content: '';
}

Custom style sheets can be appended by specifying an array of URLs in config.json.

Alternatively, you could edit src\scss\table.scss before building, but this is not recommended!