README

这个 Symfony2 扩展包允许您轻松将 symfony 文档翻译成其他语言。

里面有什么？

合并的文件管理器
带联合文本滚动的花哨双编辑器
内置 symfony.com 主题用于文档
用于生成和获取文档的命令
文件跟踪功能
视觉翻译小部件

安装

将 DarkTranslationBundle 添加到您的 composer.json 文件中

{
    "require": {
        "cursedcoder/dark-translation-bundle": "*"
    }
}

在您的 app/AppKernel.php 文件中注册扩展包

<?php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Dark\TranslationBundle\DarkTranslationBundle(),
    );
)

将扩展包添加到您的 routing.yml 文件中

dark_translation_bundle:
    resource: "@DarkTranslationBundle/Resources/config/routing.yml"

在 config.yml 文件中设置您想要翻译的文档的 URL 和本地路径

# app/config.yml
dark_translation:
    repositories:
        # you should preset url for your fork here, example 'lang_tag: fork_url'
        ru: 'https://github.com/cursedcoder/symfony-docs-ru'
    source:
       base_dir: %kernel.root_dir%/../docs
       from: %kernel.root_dir%/../docs/symfony-docs
       to: %kernel.root_dir%/../docs/symfony-docs-ru # change lang_tag here
    build:
        path: %kernel.root_dir%/../docs/build

您需要在 base_dir 文件夹中创建一个名为 info.dat 的空文件。此文件将用于跟踪翻译中的更改。

然后运行以下命令

php app/console dark-translation:fetch-docs en ru

将 ru 替换为您自己的语言标签。

别忘了资产

php app/console assets:install web/ --symlink

文档构建

使用 Sphinx 构建所有 HTML 源文件以查看文档的外观。请确保您在本地机器上安装了 Sphinx。如果没有，运行

easy_install -U sphinx
easy_install -U sphinxcontrib-phpdomain

现在您可以使用以下命令生成 HTML 源文件

php app/console dark-translation:build-docs

演示

您可以在此处看到生产演示。

cursedcoder / dark-translation-bundle

维护者

详细信息

README

里面有什么？

安装

文档构建

演示