Kit de mise en ligne d'ASW

Objectif de ce kit

Pour qui et pour quoi faire?

Si vous développez des contenus pour MSTS ou d'autres simulateurs ferroviaires, ASW peut héberger gratuitement vos travaux afin de les rendre disponibles à la communauté. Ce texte décrit étape par étape comment vous devrez procéder pour nous soumettre vos travaux afin que nous puissions les mettre en ligne.

Avant de contacter ASW
Contacter ASW et envoyer vos fichiers
Et ensuite?

Questions et contact

En cas de question sur ce texte ou sur les procédures de mise en ligne, merci de poster un message sur le forum dans la rubrique "La vie du site et du forum".

Cas particulier des activités

La création d'activités est souvent plus complexe qu'on ne le pense. De plus, leur bon fonctionnement peut parfois dépendre de différents paramètres extérieurs (paramétrage du jeu notamment). Afin d'éviter tout désagrément aux utilisateurs qui les chargeraient, les activités soumises à ASW sont testées et approuvées par une équipe de spécialistes. De ce fait, une procédure de soumission spécifique est mise en place pour les activités. Celles-ci sont soumise sur une rubrique dédiée du forum. La soumission, le test et la mise en ligne sont régis par un règlement particulier.

Section du forum consacrée à la conception et au test d'activités
Rubrique du forum où soumettre les activités
Règlement régissant la soumission, le test et la mise en ligne des activités

Avant de contacter ASW

Demandes préalables d'autorisation

Si vous utilisez des éléments réalisés par d'autres personnes, il est impératif de leur demander l'autorisation explicite de rediffusion, de préférence par e-mail. Conservez leur e-mail de réponse, car vous en aurez besoin plus tard.

Ces demandes d'autorisation concernent notamment, mais pas exclusivement: les reskins, l'inclusion de pack sonores, de cabines, de simples textures, ...

En l'absence des autorisations nécessaires, la diffusion de vos travaux sur le site sera systématiquement refusée.

Règles de nommage des fichiers

Que vous vouliez diffuser un matériel roulant, un objet de décor, un cours, il est recommandé de suivre quelques règles de nommage simples pour les fichiers qui seront installés dans MSTS:

- Eviter les espaces, les accents et les caractères spéciaux.
- Pour le matériel roulant, prévoir un nom de répertoire dans le TRAINSET permettant un tri aisé. Typiquement: "Compagnie_Engin_NomAuteur". Cela donnerait par exemple "SNCF_BB12000_ESK".
- Pour les objets de route, de préfixer le nom par celui de l'auteur, typiquement: "Auteur_NomObjet".

Il est bien entendu possible d'utiliser des acronymes.
Ces règles ne sont pas là par esprit procédurier, mais visent à éviter les problèmes de référencement sur les serveurs et à simplifier l'utilisation après installation!

Packaging

La diffusion peut se faire sous forme d'un fichier d'archive compressé (ZIP, RAR par exemple) ou d'un exécutable d'installation (.EXE obtenu avec un outil comme "InstallMaker" ou "InstallCreator" par exemple).
Le nom du fichier destiné à la diffusion (archive ou exécutable) ne doit comporter ni espace, ni accent. Eviter également les caractères spéciaux. A la place des espaces, préférez les caractères "-" ou "_".

Dans le cas de l'utilisation d'un exécutable, il est recommandé de prévoir la récupération automatique de l'emplacement où se trouve installé MSTS:

- Racine: "HKEY_LOCAL_MACHINE"
- Clef: "SOFTWARE\Microsoft\Microsoft Games\Train Simulator\1.0"
- Sous-clef: "Path"
- Emplacement par défaut: "C:\Program Files\Microsoft Games\Train Simulator"

Documentation

Le package doit contenir une documentation précise résumant les étapes nécessaires à l'installation et à l'utilisation des fichiers. Celui-ci doit également rappeler les noms ou pseudo des auteurs, ainsi que autorisations obtenues pour la diffusion d'éléments réalisés par d'autres personnes.

Cette documentation peut-être fournie au format texte/ASCII, HTML, RTF ou PDF. Le format DOC, moins générique, n'est pas recommandé.

Fiche de demande de mise en ligne

Une fiche de demande de mise en ligne permet de fournir toutes les informations nécessaires à la mise en ligne sur ASW. Il faut donc la charger sur le site d'ASW, puis la remplir aussi précisément que possible. Vous devrez utiliser pour cela soit le logiciel payant MicrosoftOffice, soit le logiciel gratuit OpenOffice.

Cette fiche est disponible en chargement en cliquant sur le bouton ci-contre. Il vous faudra la renvoyer par mail ou MP à votre contact sur ASW (?).

Imagette

Pour permettre d'illustrer les pages de mise en ligne, nous demandons une imagette de votre création. Celle-ci doit être impérativement au format JPEG. Ses dimensions minimales doivent être de 200x150 pixels.

Vous êtes libres de nous fournir une image identique mais de taille plus importante en sus de cette imagette.

Test préalable

L'équipe d'ASW teste certains des contenus proposés de manière systématique. C'est le cas notamment des lignes et des activités. Toutefois, il est fortement recommandé de faire tester vos créations par des tiers avant l'envoi pour mise en ligne!

Contacter ASW et envoyer vos fichiers

Regroupement des fournitures

Il va falloir regrouper les fichiers nécessaires, que vous avez normalement déjà préparés, dans une même archive qui sera fournie à ASW:

- La copie des autoriations reçues des auteurs dont vous incluez des éléments dans votre package. Celles-ci seront fournies de préférence sous forme de fichiers .eml. (?)
- Le package destiné à être mis en ligne (?)
- La fiche de mise en ligne remplie (?)
- L'imagette qui servira à l'illustration sur les pages de chargement (?).

Placer l'ensemble de ces fichiers dans une archive (ZIP, RAR) portant un nom explicite.

Contacter ASW

L'étape suivante consiste à contacter un des membres de l'équipe ASW ci-contre. Celui-ci se chargera ensuite de mettre vos fichiers en ligne et/ou de faire suivre la demande au sein de l'équipe. Cela peut se faire de préférence par MP sur le forum.

Contacter BB25187
Contacter Ardennes
Contacter Juerg

Envoi des fichiers vers ASW

Selon le volume total de vos fichiers, il vous sera proposé un mode d'échange adapté avec l'équipe ASW. Les plus fréquents sont les suivants:

- Mise à disposition sur un site gratuit d'hébergement de fichier, à préférer notamment pour les très gros volumes (routes). - Upload sur le FTP d'ASW à l'aide d'un outil dédié dont beaucoup sont gratuits (par exemple: filezilla). L'adresse et les identifiants vous seront communiqués par ASW. - Envoi par e-mail, à réserver uniquement aux envois représentant un volume réduit (<500ko).

De manière générale, nous souhaitons privilégier les deux premiers modes d'échange. Il est conseillé de nous contacter en cas de doute afin d'effectuer le meilleur choix!

Merci de ne jamais envoyer vos fichiers par e-mail sans en avoir prévenu au préalable le destinataire ni vous être assurés de son accord!!!

Et ensuite?

Suivi

Selon les cas, la personne que vous aurez contactée devra faire suivre les informations au sein de l'équipe. Il reste en effet pas mal de travail à réaliser!

Les transferts de fichiers

Une fois vos fichiers mis à disposition de l'équipe ASW, plusieurs transferts peuvent encore être nécessaires:

- Chargement de vos fichiers depuis le serveur d'hébergement gratuit ou le site FTP d'upload d'ASW.
- Upload sur le serveur de chargemeent d'ASW.

Verifications et tests

Le contenu de votre archive doit être vérifié. Notamment tous les éléments demandés doivent être présents. En cas de non conformité, l'équipe ASW se réserve le droit de demander des compléments, des adaptations, ou de refuser la mise en ligne.

Préparation des pages

Les pages HTML du site sont ensuite préparées pour la mise en ligne définitive.

Mise en ligne effective

Une fois les pages HTML prêtes, elles sont mises en ligne sur le serveur d'ASW.

Annonce

Enfin, une annonce est passée dans la rubrique dédiée du forum pour annoncer la nouveauté!