🌍
English
Differences
This shows you the differences between two versions of the page.
|
dev:extensions:use_scm [2014/11/07 10:19] plg updated for SVN + Github and details about Lexiglot |
— (current) | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| - | ====== Use a source code manager (SCM) ====== | ||
| - | It is highly recommended to use an SCM when you create and maintain a plugin. Piwigo.org extension manager and translation manager are both compatible with Subversion (SVN) and Github. Piwigo.org provides an SVN repository where your extension is welcomed. | ||
| - | |||
| - | === PEM (plugins repository) === | ||
| - | |||
| - | == Configure your Git or SVN repository == | ||
| - | |||
| - | Go to [[http://piwigo.org/ext/my.php|your page]] and select the migrated plugin, then click on the SCM icon {{http://piwigo.org/ext/template/images/scm.png}}. | ||
| - | |||
| - | Select Git or SVN and change the URL, don't change the other fields. You must give the root URL of your repo: | ||
| - | |||
| - | * example on Github ''%%https://github.com/Piwigo/ContactForm%%'' | ||
| - | * example on Piwigo.org SVN ''%%http://piwigo.org/svn/extensions/ContactForm%%'' | ||
| - | |||
| - | Validate. You should see the correct Github/SVN information in the bottom block, if not, double check the form. | ||
| - | |||
| - | == Release a new revision from your SCM == | ||
| - | |||
| - | Now when you release a new revision of your extension, you can let PEM do it directly from your SCM. PEM will automatically extract files, add release info, replace the version number in your source code. PEM can also detect the new languages! | ||
| - | |||
| - | If you Git, you will be able to choose a specific branch. If you use SVN, you will be able to choose a specific SVN revision. | ||
| - | |||
| - | === Lexiglot (translation platform) === | ||
| - | |||
| - | If you want to benefit from the work of the active Piwigo translation team, your plugin can be added in [[http://piwigo.org/translate|Piwigo Translate]]. You can simply ask us on [[http://piwigo.org/contact|Contact page]] or we may directly contact you about your plugin! | ||
| - | |||
| - | If your plugin is using Piwigo.org SVN, we manage the commit access. If you're on Github, here is whad you have to do: | ||
| - | |||
| - | == Authorize user == | ||
| - | |||
| - | As on SVN we use a single user to push translations to all plugins, this user is [[https://github.com/Piwigo-TranslationTeam|Piwigo-TranslationTeam]]. You must give push access to the user on your repo. | ||
| - | |||
| - | To do so, on your repository page, go to **Settings / Collaborators** and add **Piwigo-TranslationTeam**. | ||
| - | |||
| - | == Notify us == | ||
| - | |||
| - | We need to configure Lexiglot to use your Github repository. Contact one of the team members on the forum or send an email to **translate-github [at] piwigo [dot] org** to tell us what is the new location of your plugin. | ||
| - | |||
| - | By default all commits are pushed to the master branch, you can tell us if you want translations to be pushed to any other branch (the branch must already exists). | ||
| - | |||
| - | We decided to not use pull-requests because it's a bit more complicated to implement and we don't want to spam you with a bunch of PR every week (the translation team is very active !). | ||