filamentgroup / tablesaw

A group of plugins for responsive tables.
MIT License
5.48k stars 434 forks source link

Which files need to be hosted? #232

Closed kennynaoh closed 8 years ago

kennynaoh commented 8 years ago

Hello @zachleat , I am the member of cdnjs project. We want to host this library. But there is a question want to ask. I want to confirm with you about the main file need to be grab on npm. I think the main file is dist/tablesaw.js. And I think some of js file related with tablesaw under dist are necessary to add, too. All of them in dist? Please help me confirm that. Thanks for your help!

https://github.com/cdnjs/cdnjs/issues/8447

zachleat commented 8 years ago

Hey @kennynaoh I guess it comes down to what your philosophy is at cdnjs.

Here’s the dist folder for the last release, 2.0.3: https://github.com/filamentgroup/tablesaw/tree/v2.0.3/dist

tablesaw.js: is the main JS file tablesaw.css: is the main CSS file tablesaw-init.js (optional): does autoinitialization of the tablesaw components found in the DOM bare/tablesaw.bare.css (optional): alternative CSS file, lighter touch on skinning dependencies/: do not include stackonly/tablesaw.stackonly.css (optional): alternative, single mode CSS file. stackonly/tablesaw.stackonly.js (optional): alternative, single mode JS file. stackonly/tablesaw.stackonly.scss: do not include

As far as development goes, it’d be hard to recommend loading any of these files as separate requests from a CDN. But worse, tablesaw.js and tablesaw-init.js (optional) are meant to be used in tandem and we don’t really package them up in a way that would be ideal to be used in a CDN. So as it is right now, the dist directory is more for use with build processes.

Just thinking out loud, maybe it’d make more sense to have a tablesaw-with-init.js.

Anyway, that’s the relevant information for 2.0.3. Version 3.0 is imminent, though and will change some of this (we’re providing a jQuery-less version). I’m going to bundle this with the 3.0 release to better figure out a solution for some of the issues I noted above.

zachleat commented 8 years ago

Version 3.0 adds:

dist/tablesaw.jquery.js: the version that works with existing jQuery present on the page dist/stackonly/tablesaw.stackonly.jquery.js: stack-only version that works with existing jQuery present on the page

zachleat commented 8 years ago

Please reopen if you have additional questions.