Help:Howto/Move a page to translation system

Steps that need to be repeated for every page to switch it to new system

Important
Migration of translations is currently broken in mediawiki 1.30.0 because of bugs T179182 T139456

For pages in Plugin namespace

1. Make sure that English subpage has the most recent info from all of other languages. If not, update it and clean it.
2. Prepare structure of English subpage for translation
3. Adjust subpages in other languages to the same structure for easy migration of their content
   • Delete outdated parts of content or keep them in separate blocks (could be discarded during migration)
4. Copy content of English subpage to BasePage
5. Add new langbar to BasePage
6. Create good tagging of BasePage content - recursive (the most complex)
   • Keep markup out of translation as much as possible by using variables and multiple translate tags
   • Restructure page if needed but update subpages after that to follow new structure
7. Mark BasePage for translation
8. Migrate old subpages
9. Remove old langbar

For pages in Main namespace

1. Make sure that English page has the most recent info from all of other languages. If not, update it and clean it.
   • Add new langbar to it.
   • Add custom solution for changing displayed title for translations
   • Adjust categories to handle changed titles properly and automatically (by Extension:DisplaTitle)
2. Prepare structure of English page for translation
3. Copy pages in other languages to lang-code-based subpages of English page
4. Adjust those subpages to the same structure for easy migration of their content
   • Delete outdated parts of content
   • Delete old langbar
5. Create good tagging of English page - recursive (the most complex)
   • Keep markup out of translation as much as possible by using variables and multiple translate tags
   • Restructure page if needed but update subpages after that to follow new structure
6. Mark English page for translation
7. Migrate old subpages
8. Remove old langbar from English page
9. Add lang-based redirection from page with {{Resolve Language}} (if it exists) to pages in system - backward compatibility for links leading to wiki outside of it