Publish

Publish prépare un rig de travail pour sa livraison aux animateurs. Un profil définit les opérations à appliquer ; vous testez le candidat obtenu avant de l’approuver et de le livrer.

Ouvrir l’outil

from weSkel.src.ui import publish

publish.show_dockable(floating=True)  # Floating window; dock where you prefer.
# publish.show()                      # Alternative: standalone floating window.

Vue d’ensemble

weSkel | Publish · Aurora / atlas.

Repère	Fonction
1 · Réglages	Le panneau de gauche réunit le Work Rig, le projet, le profil et les destinations.
2 · Onglets	Profile présente la recette de préparation. Preparation rassemble l’exécution, le test et la décision de livraison.

Le bouton d’actualisation en haut à droite recharge les projets et profils enregistrés.

État du fichier	Rôle
Work	Votre scène de travail. Publish en conserve une copie pour le retour au travail.
Candidate	La scène préparée par le profil, en attente de votre décision.
Delivery	Le candidat approuvé, copié vers sa destination finale.

Rig et projet

Work Rig / Project · Aurora.

Repère	Fonction
1 · Rig	Scan rigs actualise la liste des rigs de la scène. Publish version commence à v001, puis propose le numéro suivant les versions livrées. Il reste modifiable et distinct de Work version.
2 · Projet	Choisissez le projet et son Profile. Open project… ouvre une bibliothèque existante ; New project… crée un projet. Set folder… règle les trois destinations depuis un dossier.
3 · Catégorie	Asset type et Subtype filtrent les profils. La production, la catégorie et l’asset du rig servent à retrouver son contexte de publication.
4 · Destinations	Candidates root, Deliveries root et Archives root sont les dossiers de sortie. Rig delivery affiche le fichier précis de l’asset ; Open ouvre son dossier.
5 · Profils	Profile storage indique le dossier de publish_library.json : les profils, leurs révisions, leurs paramètres et les destinations du projet.

Pour un nouveau projet, renseignez Project ID, Display name, Rig production et Project folder, puis Create project. Rig production doit correspondre exactement à la métadonnée prod du rig. Créez ensuite son profil avec New….

Profil de préparation

Un profil est une recette réutilisable : opérations, activation et paramètres. Les opérations proposées couvrent le nettoyage de la scène, l’affichage, les contrôleurs, les sets, le nommage et les réglages d’animation.

Profile · Body - Animation.

Repère	Fonction
1 · Opérations	Operation nomme le prescript ; Enabled indique Yes, No ou Required. Value source identifie l’origine de son activation. Double-cliquez dans Enabled pour changer une opération optionnelle.
2 · Paramètres	Sélectionnez une opération pour consulter Parameters / Provenance. Les valeurs héritées conservent leur origine. Une opération peut ne proposer aucun paramètre.

Modification	Conservation
Double-clic dans Enabled	Change seulement la prochaine préparation. Local signale un écart au profil enregistré ; aucune révision n’est créée.
Edit… → Save profile	Enregistre les changements dans une nouvelle révision. Les anciennes restent disponibles dans la liste des profils.
New… / Copy…	Crée un profil, ou une copie indépendante ou héritée d’un profil existant.

Les changements Local sont réinitialisés en changeant de rig, de projet ou de profil, en rechargeant les données ou en fermant l’outil. Pour les conserver, ouvrez Edit… puis Save profile. Required désigne une opération obligatoire ; Enabled décrit la configuration, pas le résultat d’exécution.

Préparer et tester

Action	Résultat
Prepare candidate	Capture le work, applique les opérations activées dans le Maya courant et enregistre le candidat. Les réglages utilisés sont figés pour cet essai.
Cancel preparation	Demande l’arrêt de la préparation en cours. Attendez la fin de l’opération et le résultat affiché.
Test candidate	Ouvre une copie séparée pour tester le rig manuellement. Les poses et les enregistrements de test concernent cette copie.
Return to work	Rouvre le work conservé. Disponible après la préparation ou après le test ; les modifications de test ne sont pas reportées sur le candidat.

Test candidate ne lance pas de batterie de tests automatique. Vérifiez le rig dans Maya, puis revenez au work avant de décider. Ces changements de scène réinitialisent Undo / Redo.

Preparation · atlas / v001.

Repère	Fonction
1 · Actions	Préparez le candidat, ouvrez sa copie de test ou revenez au work.
2 · Candidat	L’en-tête identifie l’asset, la version et l’état de l’essai.
3 · Résultats	Chaque opération affiche son statut et sa durée. Sélectionnez une ligne pour en consulter les détails.
4 · Détails	Les onglets donnent accès aux logs, au résultat sélectionné, aux diagnostics et à la review.

Lire les résultats

Statut	Signification
Succeeded · vert	L’opération a réussi.
Not applicable · orange	L’opération est activée, mais n’a rien de pertinent à faire sur ce candidat.
Disabled · atténué	L’opération est désactivée dans la recette utilisée.
Warning / Failed · jaune / rouge	Consultez le message et les éléments concernés avant de poursuivre.

Onglet	Contenu
Process logs	Bilan global, durée et messages de préparation.
Step details	Résultat, messages, éléments concernés et paramètres de l’opération sélectionnée.
Attempt diagnostics	Avertissements et erreurs de préparation, d’ouverture, de retour au work ou de livraison. Peut être vide.
Review	Décision, commentaires et état de livraison.

Approuver ou rejeter

Dans Preparation → Review, choisissez quoi faire du candidat après votre test. La V1 utilise la self-review : vous approuvez vous-même vos candidats.

Review · atlas / v001.

Repère	Fonction
1 · Décision	Approve and deliver demande de confirmer le test manuel et permet un commentaire, puis enchaîne approbation, archivage et livraison. Reject candidate demande un motif.
2 · Suivi	L’onglet conserve la décision et les commentaires. Une erreur de livraison conserve l’approbation : utilisez Retry delivery… après avoir corrigé sa cause.

La livraison utilise le candidat préparé, jamais les modifications de la copie de test. Après un rejet et le retour au work, les copies Maya de cet essai sont supprimées ; les logs, résultats et commentaires restent conservés. Corrigez le work puis préparez un nouvel essai.

Fichiers et historique

Un nouveau projet crée cette organisation dans le dossier choisi :

Aurora/
  publish_library.json
  candidate/
  publish/
    archives/

Les livraisons sont classées par type / sous-type / asset. Le nom du fichier reste stable pour un asset, par exemple publish/character/body/atlas/atlas_rig.ma. Une nouvelle livraison remplace la version courante ; les archives conservent l’historique.

Vous pouvez régler chaque destination séparément. Un changement de dossier concerne les prochains essais et ne déplace pas les fichiers existants. Les archives suivent Deliveries root tant que leur dossier n’a pas été personnalisé.