TransMaintain é uma ferramenta para manter os arquivos de tradução da interface do projeto symfony consistentes

"Dor é dor, como você quiser.

Isso é medo, onde há medo, não há lugar para o amor."

Agatha Christie

Quantos projetos não passaram pelas minhas mãos - sempre iguais - os arquivos de tradução estão em péssimo estado. Este problema é melhor expresso pelas palavras de Agatha Christie no início do artigo. As nuances linguísticas e a qualidade das traduções não serão compreendidas aqui. Suponha que temos traduções excelentes. Sob o corte, aqueles problemas que podem ser controlados por meios técnicos e as ferramentas projetadas para isso são resolvidos. O material é destinado a pessoas com experiência com Symfony e em geral com o console Linux. Também presume-se que você saiba como conectar pacotes configuráveis ​​de terceiros ao projeto. Portanto, algumas das questões não são tratadas do ponto de vista de "tudo está claro.

---

De todos os problemas associados às traduções, existem aqueles que são muito difíceis de controlar por meios técnicos. Por exemplo, a qualidade das traduções, seu significado semântico e a adequação do uso de certas palavras em uma parte específica da interface do usuário. E há aqueles que são tecnicamente muito fáceis de controlar. Da última categoria, que normalmente encontramos em projetos, podemos destacar:

1. Falta de algumas traduções. Mesmo se traduções para um ou dois idiomas forem adicionadas, elas não serão adicionadas para o resto.

   
   
   
   
   

2. Nenhuma tradução adicionada.

   
   
   
   
   

3. O uso de espinhos semelhantes, mas, no entanto, diferentes para as mesmas traduções.

   
   
   
   
   

4. Traduções diferentes para as mesmas chaves (chaves duplicadas). Como resultado, descobrimos que a tradução necessária está disponível, mas não o que esperamos que seja exibido.

   
   
   
   
   

Mas esta é uma manifestação externa do problema. Qual é a sua base?

3 :

1. . ? . . . . .

   
   
   
   
   

2. : . , , . . .

   
   
   
   
   

3. ? . . PHPUnit. , CI ? - , .

   
   
   
   
   

. , 100500 . , “symfony/translation”. , , . , , .

. , . Github-. Symfony 4.4+ . .

, , — “” . , YAML . . — . . , . :

1. . , , - , .

   
   
   
   
   

2. .

   
   
   
   
   

. ( ) . , .

:

aeliot_trans_maintain:yaml:transform PATH_TO_FILE_IN PATH_TO_FILE_OUT
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

Symfony. , PATH_TO_FILE_OUT PATH_TO_FILE_IN. . Linux find grep . , YAML :

find PATH_TO_DIRECTORY -type f \( -iname \*.yml -o -iname \*.yaml \) | sort | xargs  -I {} -t  php  bin/console aeliot_trans_maintain:yaml:transform $1{}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

,

. — , Google Translate. , . . .

:

bin/console aeliot_trans_maintain:yaml:export_missed_translations DOMAIN DONOR_LOCALE FILTER_BY_LOCALE
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

:

• DOMAIN — . 

  
  
  
  
  

• DONOR_LOCALE —  

  
  
  
  
  

• FILTER_BY_LOCALE — . , , . , .

  
  
  
  
  

. StdOut. . :

bin/console a:y:e messages en de > ./donor.txt
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

- , Symfony . .

PhpStorm . . , , .

! . YAML Symfony (\Symfony\Component\Yaml\Yaml::dump()), . , . .

, — . ( : insert_missed_keys). , , , .

:

• no — . .

  
  
  
  
  

• end —

  
  
  
  
  

• merge — . .

  
  
  
  
  

: no end. dev , .. . - , - .

:

parameters:
   env(TRANS_MAINTAIN_INSERT_MISSED_KEYS): no

aeliot_trans_maintain:
   insert_missed_keys: "%env(TRANS_MAINTAIN_INSERT_MISSED_KEYS)%"
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

/ TRANS_MAINTAIN_INSERT_MISSED_KEYS .env .env.local - .

. . . . … . ? ?

:

aeliot_trans_maintain:lint:yaml KEY_1 KEY_2 KEY_N
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

0 1 . StdOut . . .

:

• base — ().

  
  
  
  
  

• all — . . , base , all .

  
  
  
  
  

:

• files_missed — , . , . , .

  
  
  
  
  

• keys_missed — , . , ( ) , . , , .

  
  
  
  
  

• keys_duplicated — . , , .

  
  
  
  
  

base. , .

CI . , - , .

.

:

1. . , .

   
   
   
   
   

2. .

   
   
   
   
   

3. API Google/Yandex . .

   
   
   
   
   

. .