XTaTIK::Docs::Appendix::StaticFiles - Map of XTaTIK static files you can override
Static files can be found in XTaTIK core, your Company Silo, and your Site Silo. If files of the same name exist, your Site Silo location will take precedence over Company Silo, which in turn takes precedence over files in XTaTIK core.
This, of course, does mean you can place a static file into your Company Silo and it will be available to all of your Sites.
These static files you can override directly from either your company or site silos. You'll likely won't ever need to touch the SASS files, however.
public ├── favicon.ico ├── product-pics │ └── nopic.png ├── content-pics │ ├── nav-logo.png # Does not exist by default!! │ ├── shoutout-art.png # Does not exist by default!! │ └── index-logo.png └── sass ├── bootstrap-extras.scss ├── bs-callout.scss ├── main.scss └── reset.scss
nopic.jpg—the image file to display when product photo is not available
nopic.jpg
nav-logo.png—the little logo to display in the nav on every page. This file does not exist by default and if neither Site nor Company silos have this file, market/company text will be shown instead
nav-logo.png
index-logo.png—the large logo displayed on the home page during shoutout animation
index-logo.png
shoutout-art.jpg—if present, will be used during the first portion of shoutout animation, instead of index-logo.png
shoutout-art.jpg
sass files—these files are used to provide XTaTIK core styles. Generally, you'd use additional Company/Site SASS files instead of overriding core files. Note: this also means the filenames mentioned above are reserved and cannot be used by Company/Site silos without the overriding effect.
├── JS │ └── ** any file ** └── sass ├── bootstrap │ └── company-variables.scss └── user └── ** any file **
You can place any JavaScript file into JS directory and any SASS file into sass/user directory in your Company Silo. They sill by sorted and loaded in that order.
JS
sass/user
sort
company-variables.scss—you can use this file to override Bootstrap's and XTaTIK's SASS variables. Be sure to append !default to your variables here, so you could override them per-site from Site Silos.
company-variables.scss
!default
├── JS │ └── ** any file ** └── sass ├── bootstrap │ └── site-variables.scss └── user └── ** any file **
Same as with Company Silo files, you can place any JavaScript file into JS directory and any SASS file into sass/user directory in your Company Silo. They sill by sorted and loaded in that order.
site-variables.scss—you can use this file to override Bootstrap's and XTaTIK's SASS variables. Any Company Silo SASS variables marked with !default flag can also be overriden from here
site-variables.scss
To install XTaTIK, copy and paste the appropriate command in to your terminal.
cpanm
cpanm XTaTIK
CPAN shell
perl -MCPAN -e shell install XTaTIK
For more information on module installation, please visit the detailed CPAN module installation guide.