Quel est le rôle des dossiers src et dist?

167

Je regarde un dépôt git pour un plugin jquery. Je souhaite apporter quelques modifications à utiliser dans mon propre projet, mais lorsque j'ai ouvert le dépôt, il avait une structure que je n'avais jamais vue auparavant. Je ne sais pas quels fichiers utiliser / copier dans mon propre projet.

Il existe un dossier «dist» et un dossier «src». À quoi servent-ils? Est-ce quelque chose de spécifique pour gruntjs ou peut-être pour les plugins jquery?

Le repo git dont je suis curieux: https://github.com/ducksboard/gridster.js

javascript jquery jquery-plugins gruntjs Don P
la source
20
src : source, dist : distribution
Alan Dong

Réponses:

224

src/signifie source , et est le code brut avant la minification ou la concaténation ou une autre compilation - utilisé pour lire / éditer le code.

dist/signifie distribution , et est la version minifiée / concaténée - effectivement utilisée sur les sites de production.

Il s'agit d'une tâche courante qui est effectuée pour les actifs sur le Web afin de les réduire.

Vous pouvez voir un exemple ici: http://blog.kevinchisholm.com/javascript/node-js/javascript-concatenation-and-minification-with-the-grunt-js-task-runer/

ébats
la source
1
Pourquoi mettons-nous des fichiers tels que index.html, style.cssou même bundle.jsdans le dossier dist, n'appartiennent-ils pas au dossier src avec les autres fichiers source? - comme il s'agit de "code brut" (par exemple, un fichier html ou javascript brut?), après tout, ils n'ont pas encore été traités pour la production.
Sebastian Nielsen
3
@SebastianNielsen parce que ces fichiers que le navigateur Web récupérera et utilisera pour les afficher. Ce ne sont pas des fichiers src qui seront transpilés en autre chose. Ce sont les fichiers de distribution.
dmullings
3
@Jens Törnell Je pense que c'est bien. Ils sont tous deux valides pour le navigateur car ils ont déjà été compilés en CSS. Ce qui n'appartiendrait pas au distdossier, ce sont les fichiers source .scss ou .sass qui ont été utilisés pour créer les fichiers
.css
3
Pourquoi ne pas épeler le nom complet du dossier? Si tel était le cas, nous n'aurions pas à poser cette question ... Au lieu de cela, nous avons des noms de dossier abrégés qui ne sont pas assez bien abrégés pour en déduire leur objectif.
Marko
1
Les noms @Marko Cryptic sont une relique des débuts de l'informatique lorsque la mémoire et l'espace de stockage étaient limités. C'est surtout une question culturelle, je ne trouve aucune autre bonne raison de maintenir la coutume. Il est faux de rien à utiliser source/, public/, binaries/et libraries/. Mais certaines personnes se renfrogneront.
ximo