[DOCU-1707] Rewrite "My first translation" tutorial Created: 25/Sep/18  Updated: 18/Jan/19  Resolved: 11/Jan/19

Status: Closed
Project: Documentation
Component/s: None
Affects Version/s: None
Fix Version/s: 6.0

Type: Story Priority: Neutral
Reporter: Christoph Meier Assignee: Martin Drápela
Resolution: Done Votes: 0
Labels: tutorial
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Attachments: PNG File Screen Shot 2019-01-04 at 12.45.21.png     File bookshelf-app-messages_es REVIEWED.properties     Text File bookshelf-app-messages_es.properties     File bookshelf-app_i18n_screenshots_framed.tar.gz    
Issue Links:
Relates
relates to MGNLCT-84 Git clone operation may register app ... Closed
dependency
depends upon DOCU-1676 Rewrite "My first content app" tutorial Closed
is depended upon by DOCU-1710 Rewrite "Accessing content on the cli... Closed
is depended upon by DOCU-1711 Rewrite "Creating a website with Magn... Closed
Template:
Acceptance criteria:
Empty
Date of First Response:
Epic Link: Tutorials-for-M.6.0
Sprint: Docu Sprint 65, Docu Sprint 66
Story Points: 5

 Description   

Intro

My first translation was based on the content app which was the result of My first content app.

My first content app gets rewritten too, see DOCU-1676, using a more modern approach to create a content app.

The new My first translation should use the outcome of the new My first content app as a base to add a new translation.

Other things to change:

  • No more screenshots from an IDE to show file structures. Instead use the tree command in the shell to create and render a tree.

Possible structure

  1. Installing a Magnolia bundle (with CLI)
  2. Adding an existing content app as light-module (the "books-app" from my 1st content app)
  3. Adding a new properties file for another language
    and translating
  4. Testing the translation
  5. Special stuff .. .?
    Such as Icons (see old version), unsure whether that's required.

 Steps 1 & 2 most probably will be used for a bunch of other tutorials.
That's why it would be very nice, if the installation part (bundle & light module) would go into an includable which is easy to reuse.



 Comments   
Comment by Francisco Gonzalez [ 04/Jan/19 ]

Ariana and I have checked the i18n messages and we have modified some translations.

We have modified the following:

L:13 bookshelf-app.browser.actions.editItem.label=Editar

L:20 bookshelf-app.browser.actions.confirmDeleteFolder.confirmationMessage={0,choice,1# Se borrará el estante selectionado.|1< Se borrarán los estantes selectionados.}

L:22 bookshelf-app.browser.actions.confirmDeletion.confirmationMessage={0,choice,1#Se borrará el libro selectionado.|1< Se borrarán los libros selectionados.}

L:36 bookshelf-app.bookDetailsTab.name.description=Éste campo es obligatorio. Su valor se utiliza para crear un nombre único de catalogación de libro, el cual será visible en la subapp NAVEGADOR DE LIBROS y almacenado en el <i>books</i> workspace.<br/><br/>Un consejo: utiliza el siguiente patrón para crear el nombre de catalogación:<br/><br/><pre><Primer-apellido-del-autor> <año-de-publicación> <título-abreviado-del-libro></pre>

L:45 bookshelf-app.bookDetailsTab.publish_date.description=Si solo conoce el año de publicación, introduzca la fecha en formato AAAA-01-01.

L59: confirmation.delete.modified.message=<b>Aviso</b> <br/>Los siguientes subnodos han sido modificados pero no publicados. Si se han movido de localization, no se eliminarán correctamente de las instancias públicas. <br/> <br/> Subnodos modificados:

I attach the modified file bookshelf-app-messages_es REVIEWED.properties

We were unable to review the descriptions because they do not appear in the dialogs in Magnolia 6.

We have not been able to see the message "confirmation.delete.modified.message" in the context of the UI.

Comment by Christoph Meier [ 04/Jan/19 ]

Thanks fgonzalez and arivva.

Yes, descriptions of dialogs currently are not displayed on the M-6.0 UI. We have a ticket for this, and they will come back to 6.x sooner or later.
It could be tested with 5.7.2 (which has just been released yesterday.
Anyway, fine.
Thanks again. 

Comment by Francisco Gonzalez [ 04/Jan/19 ]

I have reviewed the descriptions in Magnolia 5.7.2 and it looks good.

Comment by Julie Legendre [ 17/Jan/19 ]

Reviewed (comments on page).

Generated at Mon Feb 12 01:20:33 CET 2024 using Jira 9.4.2#940002-sha1:46d1a51de284217efdcb32434eab47a99af2938b.