Adding an entry to the Create New menu/pt-br: Difference between revisions

    From KDE UserBase Wiki
    (Created page with "Crie uma pasta chamada {{Path|templates}} em {{Path|~/.kde4/share}}, caso esta pasta ainda não existir. Depois, entre na pasta {{Path|templates}}.")
    (Created page with "Category:Tutoriais/pt-br")
     
    (14 intermediate revisions by the same user not shown)
    Line 12: Line 12:
    Crie uma pasta chamada {{Path|templates}} em {{Path|~/.kde4/share}}, caso esta pasta ainda não existir. Depois, entre na pasta {{Path|templates}}.
    Crie uma pasta chamada {{Path|templates}} em {{Path|~/.kde4/share}}, caso esta pasta ainda não existir. Depois, entre na pasta {{Path|templates}}.


    In this folder, create a new file with {{Path|.desktop}} as file extension. For example: {{Path|custom-file.desktop}}.
    Nessa pasta, crie um novo arquivo com a extensão {{Path|.desktop}}. Por exemplo: {{Path|arquivo-personalizado.desktop}}.


    Open this new file and paste the following content inside it:
    Abra este arquivo e cole o conteúdo a seguir dentro dele:


    <source lang="ini">
    <source lang="ini">
    Line 25: Line 25:
    </source>
    </source>


    Fill these fields as follows:
    Preencha esses campos conforme abaixo:
    * '''Name''' is the text that appears in the <menuchoice>Create New</menuchoice> menu.
    * '''Name''' é o texto que aparece no menu <menuchoice>Criar novo</menuchoice>.
    *: [[Image:CustomCreateNewMenuEntry.png]]
    *: [[Image:CustomCreateNewMenuEntry.png]]
    *: "Custom Entry" is the value of the '''Name''' field.
    *: "Custom Entry" é o conteúdo do campo '''Name'''.


    * '''Comment''' is the label for the new name of files of this type. When you select your custom entry in the <menuchoice>Create New</menuchoice> menu, a dialog shows up asking you for the name of your new file, and this text is the label of the field where you enter this new name.
    * '''Comment''' é a legenda para indicação do nome dos novos arquivos desse tipo. Quando selecionar seu item personalizado no menu <menuchoice>Criar novo</menuchoice>, aparecerá uma caixa de diálogo que solicita o nome do seu novo arquivo. Esse texto será a legenda do campo onde você deverá digitar o nome.
    *: [[Image:CustomCreateNewMenuEntryComment.png]]
    *: [[Image:CustomCreateNewMenuEntryComment.png]]
    *: "New custom entry:" is the value of the '''Comment''' field.
    *: "New custom entry:" é o conteúdo do campo '''Comment'''.


    * '''URL''' is the path to a file containing the initial content that new files of this type have. These files with the initial content are usually located within the hidden {{Path|.source}} folder of the {{Path|templates}} folder, so use a relative path that starts with {{Path|.source/}}, such as {{Path|.source/custom-entry.txt}}.
    * '''URL''' é o caminho para um arquivo que contém o conteúdo inicial para novos arquivos desse tipo. Os arquivos com o conteúdo inicial estão normalmente localizados dentro da pasta oculta {{Path|.source}} da  pasta {{Path|templates}}. Por isso, use um caminho relativo que começa com {{Path|.source/}}, como {{Path|.source/item-personalizado.txt}}.


    * '''Icon''' is the code of the icon that appears in the <menuchoice>Create New</menuchoice> menu for your custom entry. The code is the filename of the icon to use. You can browse MIME type icon files at {{Path|/usr/share/icons/&lt;theme&gt;/&lt;size&gt;/mimetypes/}}. For example, to use {{Path|/usr/share/icons/&lt;theme&gt;/&lt;size&gt;/mimetypes/application-vnd.oasis.opendocument.text.png}}, fill '''Icon''' with "application-vnd.oasis.opendocument.text".
    * '''Icon''' é a identificação do ícone que aparece no menu <menuchoice>Criar novo</menuchoice> do seu item personalizado. A identificação é o nome do arquivo usado pelo ícone. Você pode navegar pelos arquivos de ícones do tipo MIME em {{Path|/usr/share/icons/&lt;tema&gt;/&lt;tamanho&gt;/mimetypes/}}. Por exemplo, para usar o ícone {{Path|/usr/share/icons/&lt;tema&gt;/&lt;tamanho&gt;/mimetypes/application-vnd.oasis.opendocument.text.png}}, preencha o campo '''Icon''' com o texto "application-vnd.oasis.opendocument.text".


    This is an example of a filled {{Path|.desktop}} file:
    Este é um exemplo de uma arquivo {{Path|.desktop}} preenchido com as informações:


    <source lang="ini">
    <source lang="ini">
    [Desktop Entry]
    [Desktop Entry]
    Name=Custom Entry
    Name=Item personalizado
    Comment=New custom entry:
    Comment=Novo item personalizado:
    Type=Link
    Type=Link
    URL=.source/custom-entry.txt
    URL=.source/custom-entry.txt
    Line 49: Line 49:
    </source>
    </source>


    === Translating the Name and Comment ===
    === Tradução do Nome e Comentário ===


    The '''Name''' and '''Comment''' fields can be translated to any language. To provide a translation, include a new field in your {{Path|.desktop}} file with the form "Field[language code]=Value" for each language that you want to support. For example:
    Os campos '''Name''' e '''Comment''' (Nome e Comentário, respectivamente) podem ser traduzidos para qualquer idioma. Para apresentar uma tradução, inclua um novo campo no seu arquivo {{Path|.desktop}} com a forma "Campo[código do idioma]=Valor" para cada um dos idiomas que você quer traduzir. Por exemplo:


    <source lang="ini">
    <source lang="ini">
    Line 57: Line 57:
    Name=Custom Entry
    Name=Custom Entry
    Name[ca]=Entrada personalitzada
    Name[ca]=Entrada personalitzada
    Name[gl]=Entrada personalizada
    Name[pt_BR]=Item personalizado
    </source>
    </source>


    == Defining the content ==
    == Definição do conteúdo ==


    Create a {{Path|.source}} folder in {{Path|~/.kde4/share/templates}} if such a folder does not exist already, and enter the hidden {{Path|.source}} folder.
    Crie uma pasta {{Path|.source}} em {{Path|~/.kde4/share/templates}}, caso não exista uma pasta com esse nome e entre na pasta oculta {{Path|.source}}.


    Create a new file with the same filename that you defined in the '''URL''' field of the metadata of your new entry, and fill the file with the default content that you want for new files created with your new entry.
    Crie um novo arquivo com o mesmo nome definido no campo '''URL''' dos metadados do seu novo item e complete o arquivo com o conteúdo padrão a ser utilizado na criação de novos itens.


    [[Category:Tutorials]]
    [[Category:Tutoriais/pt-br]]

    Latest revision as of 01:51, 27 July 2015

    Other languages:
    Tutorial que descreve como adicionar um item ao menu Criar novo dos gerenciadores de arquivos, como o Dolphin ou o Konqueror

    Os itens do menu Criar novo são chamados de templates. Eles são definidos de forma global no sistema em /usr/share/templates ou apenas para o usuário em ~/.kde4/share/templates. Neste tutorial nós mostraremos como adicionar um novo template em ~/.kde4/share/templates.

    Definição dos metadados

    Crie uma pasta chamada templates em ~/.kde4/share, caso esta pasta ainda não existir. Depois, entre na pasta templates.

    Nessa pasta, crie um novo arquivo com a extensão .desktop. Por exemplo: arquivo-personalizado.desktop.

    Abra este arquivo e cole o conteúdo a seguir dentro dele:

    [Desktop Entry]
    Name=
    Comment=
    Type=Link
    URL=
    Icon=
    

    Preencha esses campos conforme abaixo:

    • Name é o texto que aparece no menu Criar novo.
      "Custom Entry" é o conteúdo do campo Name.
    • Comment é a legenda para indicação do nome dos novos arquivos desse tipo. Quando selecionar seu item personalizado no menu Criar novo, aparecerá uma caixa de diálogo que solicita o nome do seu novo arquivo. Esse texto será a legenda do campo onde você deverá digitar o nome.
      "New custom entry:" é o conteúdo do campo Comment.
    • URL é o caminho para um arquivo que contém o conteúdo inicial para novos arquivos desse tipo. Os arquivos com o conteúdo inicial estão normalmente localizados dentro da pasta oculta .source da pasta templates. Por isso, use um caminho relativo que começa com .source/, como .source/item-personalizado.txt.
    • Icon é a identificação do ícone que aparece no menu Criar novo do seu item personalizado. A identificação é o nome do arquivo usado pelo ícone. Você pode navegar pelos arquivos de ícones do tipo MIME em /usr/share/icons/<tema>/<tamanho>/mimetypes/. Por exemplo, para usar o ícone /usr/share/icons/<tema>/<tamanho>/mimetypes/application-vnd.oasis.opendocument.text.png, preencha o campo Icon com o texto "application-vnd.oasis.opendocument.text".

    Este é um exemplo de uma arquivo .desktop preenchido com as informações:

    [Desktop Entry]
    Name=Item personalizado
    Comment=Novo item personalizado:
    Type=Link
    URL=.source/custom-entry.txt
    Icon=application-vnd.oasis.opendocument.text
    

    Tradução do Nome e Comentário

    Os campos Name e Comment (Nome e Comentário, respectivamente) podem ser traduzidos para qualquer idioma. Para apresentar uma tradução, inclua um novo campo no seu arquivo .desktop com a forma "Campo[código do idioma]=Valor" para cada um dos idiomas que você quer traduzir. Por exemplo:

    [Desktop Entry]
    Name=Custom Entry
    Name[ca]=Entrada personalitzada
    Name[pt_BR]=Item personalizado
    

    Definição do conteúdo

    Crie uma pasta .source em ~/.kde4/share/templates, caso não exista uma pasta com esse nome e entre na pasta oculta .source.

    Crie um novo arquivo com o mesmo nome definido no campo URL dos metadados do seu novo item e complete o arquivo com o conteúdo padrão a ser utilizado na criação de novos itens.