Le code de votre site
Briks écrit du vrai code pour chaque site, et il vous appartient de le lire. Le File Explorer affiche les fichiers écrits pour votre site tels que la version en ligne les contient. Les personnes disposant de droits d'édition peuvent les modifier et publier, sur toutes les formules. Sur une formule payante, toute personne de l'espace de travail peut aussi les télécharger en zip.
Ouvrir le File Explorer
Elle propose deux vues : Files, où vous lisez et modifiez, et Settings, où vous téléchargez avec une offre payante. Le titre indique quelle version est en ligne, par exemple “The code written for this site, as version 14 is live.” Tant que le site n'a pas été publié, il n'y a rien à afficher, et la page indique “Nothing published yet”.
Parcourir les fichiers
Les dossiers et les fichiers s'affichent en arborescence à gauche, dossiers d'abord, chacun par ordre alphabétique. Saisissez du texte dans Filter files pour réduire la liste par nom ou par dossier. En dessous, un compteur indique par exemple « 38 files written for this site ». Le premier fichier ouvert est content/site.ts, qui contient les informations principales du site.
| Dossier | Ce qu'il contient |
|---|---|
app/ | Les pages du site, un dossier pour chaque adresse de page. |
components/custom/ | Les sections rédigées pour votre site, comme son bandeau d'accueil, sa liste de services et son pied de page. |
content/ | Les mots et les faits du site. |
public/ | Des fichiers que le site diffuse tels quels. |
api/ | Le code serveur propre au site, s'il en a. |
db/ | La structure des données du site, s'il en stocke. |
Cliquez sur un fichier pour le lire avec les numéros de ligne. Wrap lines évite que les longues lignes ne dépassent sur le côté, et Copy place tout le fichier dans votre presse-papiers. Les images et les autres fichiers qui ne sont pas du texte sont listés mais pas affichés, et ils font partie du téléchargement avec une offre payante.
Modifier un fichier et le publier
Les Editors, Admins et Owners obtiennent un éditeur à l'ouverture d'un fichier. Les Viewers voient tous les fichiers en lecture seule.
Ouvrir le fichier
Où : Files
Cliquez dessus dans l'arborescence. L'éditeur s'ouvre avec son texte.
Faites votre modification
Où : Editor
Saisissez comme dans n'importe quel éditeur de code. Le fichier est marqué Edited, et son dossier affiche un point lorsqu'il est fermé. Undo changes remet un fichier tel qu'il était.
Ajoutez ou supprimez des fichiers si nécessaire
Où : Files
New file demande un chemin dans
app/,components/custom/,content/,api/,db/oupublic/. Delete marque un fichier pour suppression, et Keep file vous permet de changer d'avis.Enregistrer et publier
Où : Editor
Appuyez sur Save and publish dans la barre du bas, ou sur Ctrl+S (⌘S sur Mac). La boîte de dialogue liste chaque fichier modifié.
Ajouter une note
Où : Dialog
Si vous le souhaitez, indiquez ce qui a changé dans Note. Cela est conservé dans l'historique des versions.
Confirmer
Où : Dialog
Appuyez sur Save and publish. La barre indique, par exemple, « Publishing 2 changed files. » avec un lien pour suivre l'opération dans le Studio.
Ce qui se passe après l'enregistrement
Briks construit le site avec vos fichiers et le publie, généralement en quelques minutes. Rien n'est repensé ni réécrit, et aucun crédit n'est réservé ni facturé. Le studio affiche Verifying build et Publishing, puis une réponse du type « Your code changes are live: 2 files changed in the File Explorer. Nothing else about the site changed. » De retour dans le File Explorer, une barre verte indique « Your changes are published and live. » avec Open the site.
L'enregistrement devient une nouvelle version marquée Change, que la flèche d'annulation au-dessus de l'aperçu permet d'annuler. Les modifications que vous demandez ensuite dans la conversation partent de vos fichiers modifiés. Les modifications publiées depuis l'éditeur visuel sont écrites dans ces mêmes fichiers : vous les voyez donc ici une fois en ligne.
Si votre code ne se compile pas, rien n'est publié et le site en ligne reste tel qu'il était. Un encadré rouge indique « Nothing was published », nomme le fichier où la compilation s'est arrêtée et affiche en dessous les lignes de la compilation elle-même. Vos modifications sont toujours là : appuyez sur le bouton Open de ce fichier pour aller à la ligne, corrigez, puis publiez de nouveau.
| Limite | Montant |
|---|---|
| Fichiers dans un enregistrement | 50 |
| Un fichier que vous pouvez modifier | 256 KB (les fichiers plus volumineux sont affichés en lecture seule) |
| Toutes les modifications en une seule sauvegarde | 2 Mo |
| La note | 300 caractères |
Un enregistrement est refusé, avec le motif, si le site a changé depuis l'ouverture de la page (« The site changed since you opened it: reload to see the new version. »), pendant qu'une construction est en cours, ou pendant qu'un test A/B est actif. Quelques fichiers sont écrits par le studio avant chaque construction, donc ils ne peuvent pas être modifiés ici, et le File Explorer l'indique si vous essayez.
Télécharger le code
Le téléchargement du code est inclus avec une offre payante. Avec Free, le bouton Download code et les boutons Download dans Backups ne s'affichent pas. Une note indique “Downloading the code comes with a paid plan.”, et See what's included ouvre la fenêtre de mise à niveau sur Download your site's code. Parcourir et modifier les fichiers reste possible avec toutes les offres.
Aller à la vue Settings
Où : File Explorer
Ouvrez Settings, File Explorer, puis la vue Settings à côté de Files.
Télécharger
Où : Export
Appuyez sur Download code. Vous obtenez un zip nommé d'après l'adresse et la version du site, par exemple
harbour-plumbing-version-14.zip.
Pour une version antérieure, ouvrez Settings, Backups : chaque version a son propre bouton Download. La ligne Download code porte une étiquette Paid.
Ce que contient le zip, et ce qu'il ne contient pas
Le zip contient les fichiers écrits pour votre site : ses pages, ses sections, ses textes et ses propres fichiers, exactement tels que cette version les avait. Il exclut les blocs de construction communs que le studio fournit à chaque site, les fichiers qui configurent la construction et tout ce qui est secret. Comme ces éléments communs manquent, le zip ne s'exécute pas et ne se construit pas seul.
C'est donc un enregistrement et une référence plutôt qu'une copie portable. On s'en sert pour conserver une archive de ce qui a été mis en ligne, pour montrer à un développeur comment une section a été faite, ou pour rechercher les textes du site dans son propre éditeur.
Une agence avec six sites clients télécharge le zip de chaque site après le lancement et le range avec le contrat du client.
Chaque zip contient les pages et les textes de la version de lancement, pour qu'ils puissent montrer exactement ce qui a été mis en ligne et quand.
La responsable administrative de la clinique trouve le fichier qui contient les horaires d'ouverture, remplace le vendredi par 8 h à 16 h, ajoute la note
Winter hourset appuie sur Save and publish.
Quelques minutes plus tard, le site affichait les nouveaux horaires. Versions l'a listé comme un Change, et aucun crédit n'a été utilisé.
Les Viewers peuvent-ils modifier le code ?
Non. Ils peuvent lire tous les fichiers et, avec une offre payante, télécharger le zip.
Puis-je télécharger le code avec Free ?
Non. Le téléchargement du code est inclus avec une offre payante, à partir de Starter. Avec Free, vous pouvez tout de même parcourir chaque fichier et, si vous avez les droits de modification, les modifier et les publier.
Briks écrasera-t-il mes modifications ?
Les modifications que vous demandez plus tard partent de vos fichiers. Une modification peut tout de même retravailler un fichier qu'elle touche, alors mentionnez votre retouche si vous demandez à Briks de changer la même section.
Puis-je ajouter des images ici ?
Non. Les images et les autres fichiers qui ne sont pas du texte ne peuvent pas être créés dans le File Explorer. Utilisez l'onglet Media ou Storage.