From 63ae2bdee38f47750e8204c8a8bfbee96e7141c5 Mon Sep 17 00:00:00 2001 From: Luiz Fernando de Freitas Matos Date: Wed, 23 Mar 2016 11:38:53 -0300 Subject: [PATCH] Primeira versão do Manual --- Makefile | 5 ++--- capitulos/32-noosfero-conteudos.tex | 24 ++++++++++++------------ capitulos/33-noosfero-software.tex | 20 ++++++++++---------- capitulos/5-gitlab.tex | 278 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++-------------------------------------------------------------- capitulos/6-git.tex | 2 +- editaveis/abreviaturas.tex | 11 ----------- editaveis/informacoes.tex | 19 +++---------------- figuras/add_members.png | Bin 0 -> 20609 bytes figuras/andamento_milestone.png | Bin 0 -> 51008 bytes figuras/botao_addmember.png | Bin 0 -> 2115 bytes figuras/botao_adduser.png | Bin 0 -> 1634 bytes figuras/botao_closemilestone.png | Bin 0 -> 2294 bytes figuras/botao_createmilestone.png | Bin 0 -> 2218 bytes figuras/botao_importmembers.png | Bin 0 -> 1591 bytes figuras/botao_labels.png | Bin 0 -> 460 bytes figuras/botao_members.png | Bin 0 -> 1596 bytes figuras/botao_milestone.png | Bin 0 -> 1608 bytes figuras/botao_newgroup.png | Bin 0 -> 1842 bytes figuras/botao_newissue.png | Bin 0 -> 1610 bytes figuras/botao_newmember.png | Bin 0 -> 2592 bytes figuras/botao_newpage.png | Bin 0 -> 1875 bytes figuras/botao_removeproject.png | Bin 0 -> 1997 bytes figuras/botao_sshkeys.png | Bin 0 -> 2182 bytes figuras/cadastro_eventos.png | Bin 0 -> 34366 bytes figuras/cadastro_milestone.png | Bin 0 -> 38843 bytes figuras/confirm_transfer.png | Bin 0 -> 31777 bytes figuras/create_group.png | Bin 0 -> 40824 bytes figuras/criacao_projeto.png | Bin 0 -> 51534 bytes figuras/default_label.png | Bin 0 -> 47076 bytes figuras/issue_tracker.png | Bin 0 -> 47040 bytes figuras/label_assignto.png | Bin 0 -> 1702 bytes figuras/menulateral_issues.png | Bin 0 -> 22027 bytes figuras/menusup_gitlab.png | Bin 0 -> 8003 bytes figuras/perfil_gitlab.png | Bin 0 -> 77747 bytes figuras/project_member.png | Bin 0 -> 20704 bytes figuras/tela_cadastroissue.png | Bin 0 -> 44925 bytes figuras/tela_cadastromember.png | Bin 0 -> 17363 bytes figuras/tela_criacaomilestone.png | Bin 0 -> 40433 bytes figuras/tela_exclusaoprojeto.png | Bin 0 -> 34736 bytes figuras/tela_groupmembers.png | Bin 0 -> 34475 bytes figuras/tela_grupos.png | Bin 0 -> 37734 bytes figuras/tela_members.png | Bin 0 -> 23867 bytes figuras/tela_milestones.png | Bin 0 -> 12378 bytes figuras/tela_novapagwiki.png | Bin 0 -> 13592 bytes figuras/tela_projetogitlab.png | Bin 0 -> 86583 bytes figuras/tela_sshkeys.png | Bin 0 -> 41884 bytes figuras/transfer_project.png | Bin 0 -> 25230 bytes fixos/informacoes.tex | 8 +++----- fixos/novosComandos.tex | 57 --------------------------------------------------------- manual.tex | 8 ++------ 50 files changed, 249 insertions(+), 183 deletions(-) create mode 100644 figuras/add_members.png create mode 100644 figuras/andamento_milestone.png create mode 100644 figuras/botao_addmember.png create mode 100644 figuras/botao_adduser.png create mode 100644 figuras/botao_closemilestone.png create mode 100644 figuras/botao_createmilestone.png create mode 100644 figuras/botao_importmembers.png create mode 100644 figuras/botao_labels.png create mode 100644 figuras/botao_members.png create mode 100644 figuras/botao_milestone.png create mode 100644 figuras/botao_newgroup.png create mode 100644 figuras/botao_newissue.png create mode 100644 figuras/botao_newmember.png create mode 100644 figuras/botao_newpage.png create mode 100644 figuras/botao_removeproject.png create mode 100644 figuras/botao_sshkeys.png create mode 100644 figuras/cadastro_eventos.png create mode 100644 figuras/cadastro_milestone.png create mode 100644 figuras/confirm_transfer.png create mode 100644 figuras/create_group.png create mode 100644 figuras/criacao_projeto.png create mode 100644 figuras/default_label.png create mode 100644 figuras/issue_tracker.png create mode 100644 figuras/label_assignto.png create mode 100644 figuras/menulateral_issues.png create mode 100644 figuras/menusup_gitlab.png create mode 100644 figuras/perfil_gitlab.png create mode 100644 figuras/project_member.png create mode 100644 figuras/tela_cadastroissue.png create mode 100644 figuras/tela_cadastromember.png create mode 100644 figuras/tela_criacaomilestone.png create mode 100644 figuras/tela_exclusaoprojeto.png create mode 100644 figuras/tela_groupmembers.png create mode 100644 figuras/tela_grupos.png create mode 100644 figuras/tela_members.png create mode 100644 figuras/tela_milestones.png create mode 100644 figuras/tela_novapagwiki.png create mode 100644 figuras/tela_projetogitlab.png create mode 100644 figuras/tela_sshkeys.png create mode 100644 figuras/transfer_project.png diff --git a/Makefile b/Makefile index 94ec337..f23dcdc 100644 --- a/Makefile +++ b/Makefile @@ -6,7 +6,7 @@ LATEX = pdflatex VERSION = 0.1.0 FIXOS_DIR = fixos -FIXOS_SOURCES = informacoes.tex novosComandos.tex fichaCatalografica.tex \ +FIXOS_SOURCES = informacoes.tex novosComandos.tex \ pacotes.tex comandos.tex setup.tex \ listasAutomaticas.tex indiceAutomatico.tex @@ -14,8 +14,7 @@ FIXOS_FILES = $(addprefix $(FIXOS_DIR)/, $(FIXOS_SOURCES)) EDITAVEIS_DIR = editaveis EDITAVEIS_SOURCES = resumo.tex \ - abreviaturas.tex \ - apendices.tex anexos.tex + abreviaturas.tex EDITAVEIS_FILES = $(addprefix $(EDITAVEIS_DIR)/, $(EDITAVEIS_SOURCES)) diff --git a/capitulos/32-noosfero-conteudos.tex b/capitulos/32-noosfero-conteudos.tex index ba9af62..4eb4bf1 100644 --- a/capitulos/32-noosfero-conteudos.tex +++ b/capitulos/32-noosfero-conteudos.tex @@ -40,12 +40,12 @@ Nas seções abaixo, serão apresentados alguns dos conteúdos que o Noosfero of Um artigo no Noosfero é a página/conteúdo que contém todo o conteúdo escrito de outros conteúdos no Noosfero, seja ele um Blog ou Fórum, por exemplo. Através da do artigo, o usuário pode disponibilizar um texto para ser publicado em seu blog de notícias ou mesmo em um link no bloco lateral da comunidade. -Para incluir um artigo (páginas) basta selecionar a opção \includegraphics[width=2.4cm]{figuras/artigo_texto.png} (Artigo de texto com editor visual). Quando esse artigo é selecionado, é necessário preencher as informações do artigo, assim como o corpo da mensagem, como apresentado na Figura \ref{fig:cadastro_artigo}. Também é possível a criação de artigos usando as linguagens de marcações HTML ou Textile (deficiente visual). +Para incluir um artigo (páginas) basta selecionar a opção \includegraphics[width=4cm]{figuras/artigo_texto.png} (Artigo de texto com editor visual). Quando esse artigo é selecionado, é necessário preencher as informações do artigo, assim como o corpo da mensagem, como apresentado na Figura \ref{fig:cadastro_artigo}. Também é possível a criação de artigos usando as linguagens de marcações HTML ou Textile (deficiente visual). \graphicspath{{figuras/}} \begin{figure}[H] \centering - \includegraphics[width=.6\textwidth]{cadastro_artigo.png} + \includegraphics[width=1\textwidth]{cadastro_artigo.png} \caption{Cadastro das informações do artigo} \label{fig:cadastro_artigo} \end{figure} @@ -56,10 +56,10 @@ Quando selecionada a opção de um artigo utilizando o editor visual, é possív O Noosfero também fornece a possibilidade de manter um blog de notícias. Através do blog, é possível manter as principais informações e notícias de uma determinada comunidade, pessoa ou software. Como exemplo, você pode criar uma notícia para divulgar uma nova versão do seu software. -Todo software criado, já possui uma área própria de notícias. Ela pode ser acessada em: +Todo software criado, já possui uma área própria de notícias por padrão. Ela pode ser acessada em: \begin{lstlisting}[basicstyle=\small] -https://portal.softwarepublico.gov.br/social/profile/[nomedosoftware]/blog +https://softwarepublico.gov.br/social/profile/[nomedosoftware]/blog \end{lstlisting} Você pode acessá-la no bloco lateral direito da página de software, na opção Notícias, conforme mostrado pela Figura \ref{fig:bloco_participee}. @@ -67,14 +67,14 @@ Você pode acessá-la no bloco lateral direito da página de software, na opçã \graphicspath{{figuras/}} \begin{figure}[H] \centering - \includegraphics[width=.6\textwidth]{bloco_participe.png} + \includegraphics[width=.25\textwidth]{bloco_participe.png} \caption{Bloco de participação com o acesso ao blog de notícias.} \label{fig:bloco_participee} \end{figure} É possivel a criação de novos posts, clonar posts ou configurar posts existentes. Cada post corresponde a uma notícia. -Para incluir outros blogs é necessário Incluir outros conteúdos e selecionar a opção \includegraphics[width=2.4cm]{figuras/conteudo_blog.png} preenchendo as informações da tela disponível na Figura X. +Para incluir outros blogs é necessário Incluir outros conteúdos e selecionar a opção \includegraphics[width=4.4cm]{figuras/conteudo_blog.png} (blog) preenchendo as informações da tela disponível na Figura \ref{fig:tela_blog}. \graphicspath{{figuras/}} \begin{figure}[H] @@ -89,17 +89,17 @@ Para incluir outros blogs é necessário Incluir outros conteúdos e selecionar O Noosfero possui suporte para criação de eventos, que são utilizadas para divulgação de alguma data importante sobre o projeto. Seu funcionamento é semelhante aos eventos de e-mail do Gmail, Outlook ou Facebook. É possível criar um evento em uma determinada data e hora e divulgá-lo para os membros da comunidade. -Para incluir um evento basta selecionar a opção \includegraphics[width=2.4cm]{figuras/botao_evento.png} de acordo com o demonstrado em Incluir outros conteúdos e preencher as informações do evento, conforme imagem ilustrada pela Figura \ref{fig:tela_eventos}. +Para incluir um evento basta selecionar a opção \includegraphics[width=3.4cm]{figuras/botao_evento.png} (Evento) de acordo com o demonstrado em Incluir outros conteúdos e preencher as informações do evento, conforme imagem ilustrada pela Figura \ref{fig:tela_eventos}. \graphicspath{{figuras/}} \begin{figure}[H] \centering - \includegraphics[width=.6\textwidth]{tela_eventos.png} + \includegraphics[width=1\textwidth]{cadastro_eventos.png} \caption{Tela com informações para criação de eventos.} \label{fig:tela_eventos} \end{figure} -Após a criação do evento, pode ser feito uma alteração nos blocos laterais para que ele seja visualizado pelos usuários e membros da plataforma. Para isso, deve selecionar a opção \includegraphics[width=2.4cm]{figuras/opcaobloco_evento.png} nos blocos laterais. +Após a criação do evento, pode ser feito uma alteração nos blocos laterais para que ele seja visualizado pelos usuários e membros da plataforma. Para isso, deve selecionar a opção \includegraphics[width=4.7cm]{figuras/opcaobloco_evento.png} (Eventos da comunidades do software) nos blocos laterais. Se o bloco foi adicionado corretamente, ele deve aparecer na comunidade do software, conforme visto na Figura \ref{fig:bloco_eventos}. @@ -119,7 +119,7 @@ O Noosfero permite a criação de Pastas, que possuem o mesmo esquema das pastas O código fonte é recomendado que seja guardado no repositório, explicado no capítulo \ref{cap:gitlab}). \end{tcolorbox} -Para criação de uma Pasta basta selecionar a opção \includegraphics[width=2.4cm]{figuras/botao_pasta.png}, como demonstrado na Figura \ref{fig:tela_pasta}. O usuário deve inserir o nome da pasta desejada, a licença aplicada, alguma descrição relevante para a pasta, categorias que podem ajudar na busca além da visibilidade. +Para criação de uma pasta basta selecionar a opção \includegraphics[width=4.4cm]{figuras/botao_pasta.png} (Pasta), como demonstrado na Figura \ref{fig:tela_pasta}. O usuário deve inserir o nome da pasta desejada, a licença aplicada, alguma descrição relevante para a pasta, categorias que podem ajudar na busca além da visibilidade. \graphicspath{{figuras/}} \begin{figure}[H] @@ -129,7 +129,7 @@ Para criação de uma Pasta basta selecionar a opção \includegraphics[width=2. \label{fig:tela_pasta} \end{figure} -Para a inclusão de arquivos, o usuário deve acessar a opção \includegraphics[width=2.4cm]{figuras/botao_arquivoenv.png}. Essa opção permite que o usuário envie qualquer arquivo da máquina diretamente para o SPB (Noosfero), a Figura \ref{fig:tela_arquivoenv} ilustra a tela de upload de arquivos. Nessa tela o usuário deve apenas selecionar o arquivo dentro da máquina. +Já na inclusão de arquivos, o usuário deve acessar a opção \includegraphics[width=4.4cm]{figuras/botao_arquivoenv.png} (Arquivo enviado). Essa opção permite que o usuário envie qualquer arquivo da máquina diretamente para o SPB (Noosfero), a Figura \ref{fig:tela_arquivoenv} ilustra a tela de upload de arquivos. Nessa tela o usuário deve apenas selecionar o arquivo dentro da máquina. \graphicspath{{figuras/}} \begin{figure}[H] @@ -143,7 +143,7 @@ Para a inclusão de arquivos, o usuário deve acessar a opção \includegraphics O conteúdo Fórum, permite a criação de tópicos de discussões e debates entre os usuários sobre uma determinada questão sobre o software ou comunidade\footnote{Maiores informações: https://pt.wikipedia.org/wiki/F\%C3\%B3rum\_de\_discuss\%C3\%A3o}. -Para incluir um fórum basta selecionar a opção \includegraphics[width=2.4cm]{figuras/tela_forum.png} (Fórum). Logo após, a tela mostrada pela Figura \ref{fig:tela_forum} será mostrada. Nessa tela o usuário deve informar o nome do fórum, descrição, licença, posts por página e termo de uso. +Para incluir um fórum basta selecionar a opção \includegraphics[width=4.4cm]{figuras/botao_forum.png} (Fórum). Logo após, a tela mostrada pela Figura \ref{fig:tela_forum} será mostrada. Nessa tela o usuário deve informar o nome do fórum, descrição, licença, posts por página e termo de uso. \graphicspath{{figuras/}} \begin{figure}[H] diff --git a/capitulos/33-noosfero-software.tex b/capitulos/33-noosfero-software.tex index 53a8b81..2f0b413 100644 --- a/capitulos/33-noosfero-software.tex +++ b/capitulos/33-noosfero-software.tex @@ -60,7 +60,7 @@ A página de software contém o resumo de informações do software, para que os Na \hyperref[sub:localizando_soft]{página de localização dos softwares}, existem diversas categorias que auxiliam o usuário a localizar o(s) software(s) mais rapidamente, conforme ilustrado pela Figura \ref{fig:pagina_exemplo}. Essas categorias podem ser editadas, caso seja de interesse do coordenador. \graphicspath{{figuras/}} -\begin{figure}[htb!] +\begin{figure}[H] \centering \includegraphics[width=0.95\textwidth]{filtro_software.png} \caption{Busca de softwares por categorias.} @@ -70,9 +70,9 @@ Na \hyperref[sub:localizando_soft]{página de localização dos softwares}, exis Para editar as categorias de um software, o coordenador deve acessar \hyperref[sub:painel_controle]{o painel de controle} do software. Após isso, ele deve clicar na opção \includegraphics[width=3.2cm]{figuras/infoconf_comunidade.png}(informações e configurações da comunidade). Na tela disponibilizada pela Figura \ref{fig:categorias_software}, é possível observar uma opção para Categorizar o Software. É possível associar o software a uma ou mais categorias. \graphicspath{{figuras/}} -\begin{figure}[htb!] +\begin{figure}[H] \centering - \includegraphics[width=0.5\textwidth]{categorias_software} + \includegraphics[width=0.55\textwidth]{categorias_software} \caption{Categorias de um software.} \label{fig:categorias_software} \end{figure} @@ -96,7 +96,7 @@ Há também outros dados adicionais que não são obrigatórios, como por exempl \graphicspath{{figuras/}} \begin{figure}[htb!] \centering - \includegraphics[width=0.8\textwidth]{relato_uso.png} + \includegraphics[width=0.65\textwidth]{relato_uso.png} \caption{Tela para cadastro de um relato de uso no software.} \label{fig:relato_uso} \end{figure} @@ -130,12 +130,12 @@ Para acesso ao painel de controle do software é utilizado o mesmo procedimento No painel de controle da página de software, é possível o coordenador alterar as principais informações sobre o software (plataformas, descrição, características, link de demonstração, sistemas operacionais suportados, dentre outras informações) -Para acessar o painel de controle basta clicar na opção \includegraphics[width=2.4cm]{figuras/botao_infosoftware.png} (Informação de Software). Após acessar essa opção, a tela mostrada pela Figura \ref{fig:alteracoes_software} será disponibilizada. Esta tela possui duas abas, sendo a primeira aba destinada a informações mais básicas, e a segunda aba sendo de informações mais técnicas. +Para acessar o painel de controle basta clicar na opção \includegraphics[width=4cm]{figuras/botao_infosoftware.png} (Informação de Software). Após acessar essa opção, a tela mostrada pela Figura \ref{fig:alteracoes_software} será disponibilizada. Esta tela possui duas abas, sendo a primeira aba destinada a informações mais básicas, e a segunda aba sendo de informações mais técnicas. \graphicspath{{figuras/}} \begin{figure}[htb!] \centering - \includegraphics[width=0.8\textwidth]{edicao_software.png} + \includegraphics[width=0.7\textwidth]{edicao_software.png} \caption{Tela para alterações no cadastro do software.} \label{fig:alteracoes_software} \end{figure} @@ -145,20 +145,20 @@ Para acessar o painel de controle basta clicar na opção \includegraphics[width \subsection{Alterando e Adicionando Links e Bloco do Software} \label{sec:block_software} -É possível editar os hiperlinks e blocos existentes na página de um software. Para isso é necessário que o usuário seja administrador do software \hyperref[sub:painel_controle]{e acesse o Painel de Controle}. Com o painel de controle acessado, o usuário deve acessar a opção \includegraphics[width=3.2cm]{figuras/editar_blocos.png}(Editar blocos laterais). Na seção \ref{ref:blocos_laterais}, é apresentado um breve tutorial sobre a edição dos blocos laterais de uma comunidade, no entanto, o procedimento para software é o mesmo. +É possível editar os hiperlinks e blocos existentes na página de um software. Para isso é necessário que o usuário seja administrador do software \hyperref[sub:painel_controle]{e acesse o Painel de Controle}. Com o painel de controle acessado, o usuário deve acessar a opção \includegraphics[width=3.7cm]{figuras/editar_blocos.png}(Editar blocos laterais). Na seção \ref{ref:blocos_laterais}, é apresentado um breve tutorial sobre a edição dos blocos laterais de uma comunidade, no entanto, o procedimento para software é o mesmo. \subsection{Disponibilizando uma nova versão de um software no Portal} Quando o software é disponibilizado e feito a revisão dos textos/blocos/links no software o último passo é disponibilizá-lo para download. Para isso o usuário deve acessar o seu painel de controle, acessar a opção "Gerenciar Conteúdo". -É recomendado que o usuário crie uma pasta para colocar as versões estáveis do software, que serão disponibilizadas para Download. Para isso o usuário deve acessar a opção \includegraphics[width=3.2cm]{figuras/novo_conteudo.png}(Novo conteúdo) e logo em seguida \href{sub:folder}{Pasta}. +É recomendado que o usuário crie uma pasta para colocar as versões estáveis do software, que serão disponibilizadas para Download. Para isso o usuário deve acessar a opção \includegraphics[width=2.8cm]{figuras/novo_conteudo.png}(Novo conteúdo) e logo em seguida \href{sub:folder}{Pasta}. Logo depois de criar a pasta e subir os conteúdos relacionados ao software. Deve-se escolher a opção \href{sec:block_software}{editar blocos laterais} no painel de controle da página do Software. Para editar o bloco de downloads (Figura \ref{fig:bloco_downloads}), o usuário deve clicar no botão \includegraphics[width=.45cm]{editar.png}(editar) no bloco de download do software, onde será aberta uma popup, conforme é mostrado na Figura \ref{fig:bloco_estavel}. \graphicspath{{figuras/}} \begin{figure}[htb!] \centering - \includegraphics[width=0.8\textwidth]{bloco_downloads.png} + \includegraphics[width=0.7\textwidth]{bloco_downloads.png} \caption{Bloco de download do software.} \label{fig:bloco_downloads}. \end{figure} @@ -166,7 +166,7 @@ Logo depois de criar a pasta e subir os conteúdos relacionados ao software. Dev \graphicspath{{figuras/}} \begin{figure}[htb!] \centering - \includegraphics[width=0.8\textwidth]{bloco_estavel.png} + \includegraphics[width=0.38\textwidth]{bloco_estavel.png} \caption{Tela de alteração do bloco de downloads do software.} \label{fig:bloco_estavel}. \end{figure} diff --git a/capitulos/5-gitlab.tex b/capitulos/5-gitlab.tex index fe6e092..42cf946 100644 --- a/capitulos/5-gitlab.tex +++ b/capitulos/5-gitlab.tex @@ -26,7 +26,7 @@ Atualmente existe uma versão do Gitlab no novo portal do Software Público, que \section{Trabalhando com o Gitlab} \subsection{Configuração do Gitlab} -O Gitlab utiliza a chave pública SSH da máquina para realizar a autenticação sem a necessidade da utilização de senhas. Através da configuração dessa chave é possível utilizar todas as funções que o Gitlab oferece, para realizar a configuração basta: +O Gitlab utiliza a chave pública SSH da máquina para realizar a autenticação sem a necessidade da utilização de senhas. Através da configuração dessa chave é possível utilizar todas as funções que o Gitlab oferece, para realizar a configuração deve: \begin{itemize} \item Gerar a chave SSH pública e colocá-la no Gitlab. @@ -38,26 +38,39 @@ Para gerar a chave pública SSH, existe um tutorial disponível no site oficial \begin{itemize} \item Git: \url{https://git-scm.com/book/pt-br/v1/Git-no-Servidor-Gerando-Sua-Chave-P\%C3\%BAblica-SSH}; \item SPB: \url{https://softwarepublico.gov.br/social/spb/como-faco-pra-utilizar-o-ambiente-colaborativo} - \end{itemize} -Logo após gerar essa chave pública, o usuário deve adicioná-la no Gitlab do novo Software Público Brasileiro. Para isso o usuário deve: - - \begin{itemize} - \item Logar no portal SPB; - \end{itemize} - -Em seguida, o usuário deve acessar o Menu superior > Desenvolvimento > Perfil. A tela ilustrada pela Figura X será apresentada. - -IMAGEM - -Logo após o usuário, deve selecionar a opção "SSH Keys" no menu superior, de acordo com a Figura X. - -IMAGEM - -Depois de selecionar a opção "SSH Keys", o usuário vera a tela ilustrada pela Figura X. Nessa tela possui todos as chaves SSH cadastradas pelos usuários, isto é, cada chave pode ou não representar cada computador utilizado pelo desenvolvedor. Para adicionar uma nova chave, o usuário deve clicar na opção "Add SSH Key". - -IMAGEM +Logo após gerar essa chave pública, o usuário deve adicioná-la no Gitlab do novo Software Público Brasileiro. Para isso o usuário deve logar no portal SPB. + +Em seguida, o usuário deve acessar o Menu superior > Desenvolvimento > Perfil. A tela ilustrada pela Figura \ref{fig:perfil_gitlab} será apresentada. Nessa tela, é possível alterar todas as informações relativas ao ambiente do gitlab, inclusive nome, avatar, skype, linkedin, entre outros. + +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.95\textwidth]{perfil_gitlab.png} + \caption{Tela de alteração do perfil do gitlab.} + \label{fig:perfil_gitlab} +\end{figure} + +Logo após o usuário, deve selecionar a opção "SSH Keys" no menu superior, de acordo com a Figura \ref{fig:menusup_gitlab}. + +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.95\textwidth]{menusup_gitlab.png} + \caption{Menu superior do gitlab com a opção "SSH keys" logo a direita.} + \label{fig:menusup_gitlab} +\end{figure} + +Depois de selecionar a opção "SSH Keys", o usuário vera a tela ilustrada pela Figura X. Nessa tela possui todos as chaves SSH cadastradas pelos usuários, isto é, cada chave pode ou não representar cada computador utilizado pelo desenvolvedor. Para adicionar uma nova chave, o usuário deve clicar na opção \includegraphics[width=2.2cm]{figuras/botao_sshkeys.png}(Add SSH Key). + +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.75\textwidth]{tela_sshkeys.png} + \caption{Menu superior do gitlab com a opção "SSH keys" logo a direita.} + \label{fig:menusup_gitlab} +\end{figure} No momento de adição da chave SSH, o usuário deve preencher um formulário com 2 (dois) campos, que contém: \begin{itemize} @@ -65,7 +78,7 @@ No momento de adição da chave SSH, o usuário deve preencher um formulário co \item \textbf{Key} - Campo da Chave SSH gerada e que deve ser copiada para o campo. \end{itemize} -Após isso, será necessário somente a configuração do Git no ambiente de desenvolvimento do usuário, que será apresentada na seção /ref{cap:git}. +Após isso, será necessário somente a configuração do Git no ambiente de desenvolvimento do usuário, que será apresentada na seção \ref{cap:git} . %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -78,27 +91,47 @@ No link \url{https://softwarepublico.gov.br/gitlab/explore/projects}, possui tod \label{sub:gitlab_projeto} \subsubsection{Criando um novo Projeto} -Caso esteja começando um novo projeto de software, é necessário que faça a criação de um novo projeto no Gitlab. Para realizar isso, o usuário deve acessar no menu superior a opção de "Desenvolvimento" e logo após "Novo Projeto", após isso, é apresentada a tela ilustrada pela Figura X. +Caso esteja começando um novo projeto de software, é necessário que faça a criação de um novo projeto no Gitlab. Para realizar isso, o usuário deve acessar no menu superior a opção de "Desenvolvimento" e logo após "Novo Projeto", após isso, é apresentada a tela ilustrada pela Figura \ref{fig:criacao_projeto}. + +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.85\textwidth]{criacao_projeto.png} + \caption{Tela de criação de projetos no Gitlab.} + \label{fig:criacao_projeto} +\end{figure} Na tela da criação do projeto serão requisitados alguns dados como: \begin{itemize} - \item Project Name: Nome do Software; - \item Namespace: Pessoa ou grupo que terá a permissão no projeto; - \item Description: Descrição sucinta e clara do Software; - \item Visibility: Privacidade do Projeto\footnote{O Gitlab permite que os projetos possam ser configurados de acordo com a necessidade do desenvolvedor} + \item \textbf{Project Name:} Nome do Software; + \item \textbf{Namespace:} Pessoa ou grupo que terá a permissão no projeto; + \item \textbf{Description:} Descrição sucinta e clara do Software; + \item \textbf{Visibility:} Privacidade do Projeto\footnote{O Gitlab permite que os projetos possam ser configurados de acordo com a necessidade do desenvolvedor} \begin{itemize} - \item Private - O projeto só pode ser acessado pelos membros do mesmo. Além disso, ele fica oculto para todos os usuários. - \item Internal - O projeto fica aberto para os usuários, no entanto, só podem ser clonado apenas por usuários logados. - \item Public - Qualquer usuário independente de estar logado, consegue visualizar e clonar o projeto. + \item \textbf{Private} - O projeto só pode ser acessado pelos membros do mesmo. Além disso, ele fica oculto para todos os usuários. + \item \textbf{Internal} - O projeto fica aberto para os usuários, no entanto, só podem ser clonado apenas por usuários logados. + \item \textbf{Public} - Qualquer usuário independente de estar logado, consegue visualizar e clonar o projeto. \end{itemize} \end{itemize} + +\begin{tcolorbox}[colback=red!5,colframe=red!40!black,title=\textbf{Observação}] +Para acessar o projeto criado, além de outros projetos e/ou grupos que o usuário faça parte, deve acessar o seguinte endereço: +https://softwarepublico.gov.br/gitlab/ +\end{tcolorbox} + \subsubsection{Acessando a página inicial do Projeto} -Logo após a criação do repositório ou acessando um repositório já criado, o usuário será apresentado a uma mesma tela, que segue um padrão ilustrado pela Figura X. +Logo após a criação do repositório ou acessando um repositório já criado, o usuário será apresentado a uma mesma tela, que segue um padrão ilustrado pela Figura \ref{fig:criacao_projetogitlab}. -IMAGEM +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.95\textwidth]{tela_projetogitlab.png} + \caption{Tela de criação de projetos no Gitlab.} + \label{fig:criacao_projeto} +\end{figure} Conforme visto na Figura temos: @@ -118,31 +151,81 @@ Caso não seja possível continuar com o projeto, é possível realizar a transf Para realizar a transferência, o usuário deve acessar a página principal do repositório, no menu superior do Gitlab deve encontrar a opção "Settings". Logo abaixo o usuário irá encontrar a opção "Transfer Project", que é visualizado na Figura X. -IMAGEM +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.95\textwidth]{transfer_project.png} + \caption{Caixa com a opção de transferência de projeto.} + \label{fig:transfer_project} +\end{figure} + + +Nessa caixa, dentro da opção "Namespace" o usuário deve escolher o novo dono do projeto, que pode ser um membro do projeto, ou um grupo o qual o usuário seja dono. -Nessa caixa, dentro da opção "Namespace" o usuário deve escolher o novo dono do projeto, que pode ser um membro do projeto, ou um grupo o qual o usuário seja dono. Logo selecionar o novo dono, basta clicar no botão "Transfer". Será necessário fornecer uma confirmação (nome do projeto, conforme está destacado na mensagem) e depois disso o projeto será do dono informado. +Logo que selecionar o novo dono, basta clicar no botão "Transfer" e será aberta uma popup. Nessa popup é necessário fornecer uma confirmação, que é o nome do projeto (de acordo com o link), conforme está destacado na Figura \ref{fig:confirm_transfer}. Após a confirmação, o projeto será repassado para o dono informado. + + +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.75\textwidth]{confirm_transfer.png} + \caption{Caixa com a confirmação de transferência do projeto.} + \label{fig:confirm_transfer} +\end{figure} \subsubsection{Excluíndo o Projeto} Para excluir um projeto, o usuário deve acessar a página inicial do projeto e entrar nas configurações, escolhendo a opção "Settings", que está localizada na barra superior do Gitlab. +Na tela de configuração, o usuário deve localizar a opção "Remove project", conforme Figura \ref{fig:remove_project}. Depois deve selecionar o botão chamado de \includegraphics[width=2.65cm]{figuras/botao_removeproject.png} (Remove project). -Na tela de configuração, o usuário deve localizar a opção "Remove project", conforme Figura X. Depois deve selecionar o botão chamado de "Remove project". +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=1\textwidth]{remove_project.png} + \caption{Caixa com a opção de exclusão do projeto.} + \label{fig:remove_project} +\end{figure} +Será aberta uma popup pedindo para confirmação da exclusão do projeto, para isso, é necessário digitar o nome do projeto de acordo com o destacado pela Figura \ref{fig:confirm_remove} (geralmente o nome do projeto é de acordo com o link). Feito esses passos, o projeto já está excluído: -Será aberta uma popup pedindo para o usuário confirmar a exclusão do projeto, para isso, ele deve digitar o nome do projeto de acordo com o destacado pela mensagem. Feito esses passos, o projeto já está excluído: +\graphicspath{{figuras/}} +\begin{figure}[htb!] + \centering + \includegraphics[width=.9\textwidth]{tela_exclusaoprojeto.png} + \caption{Caixa com a confirmação de exclusão do projeto.} + \label{fig:confirm_remove} +\end{figure} -Observação: É importante ressaltar que uma vez que o projeto é excluído, não será possível recuperá-lo, então utilize essa opção se tiver certeza que deseja excluir. +\begin{tcolorbox}[colback=red!5,colframe=red!40!black,title=\textbf{Observação}] +É importante ressaltar que uma vez que o projeto é excluído, não será possível recuperá-lo, então utilize essa opção se tiver certeza que deseja excluir. +\end{tcolorbox} \subsubsection{Adicionando membros aos projetos} É possível que um projeto tenha mais de um membro trabalhando simultaneamente. Isso permite que uma equipe possa trabalhar dentro de um projeto, sem a necessidade de cada um ter o seu próprio repositório. -Para adicionar membros no projeto, o usuário deve acessar o menu superior e selecionar a opção "Settings". Após, em um menu localizado na esquerda deve acessar a opção *MEMBERS*. +Para adicionar membros no projeto, o usuário deve acessar o menu superior e selecionar a opção "Settings". Após, em um menu localizado na esquerda deve acessar a opção \includegraphics[width=2.65cm]{figuras/botao_members.png}(Members). + +Na tela ilustrada pela Figura X, é apresentado todos os membros que fazem parte do projeto, assim como as permissões associadas\footnote{O gitlab permite que o dono do repositório atribua papéis para cada membro que vai fazer parte do projeto, mais informações são disponibilizadas em: https://softwarepublico.gov.br/gitlab/help/permissions/permissions}. Para adicionar um novo membro, basta acessar a opção \includegraphics[width=2.95cm]{figuras/botao_newmember.png}(New Project Member). Caso queira importar uma lista de outro projeto, selecione a opção \includegraphics[width=2.65cm]{figuras/botao_importmembers.png}(Import Member). + +\graphicspath{{figuras/}} +\begin{figure}[htb!] + \centering + \includegraphics[width=1\textwidth]{tela_members.png} + \caption{Tela com relação de membros que fazem parte do projeto.} + \label{fig:tela_members} +\end{figure} -Na tela ilustrada pela Figura X, é apresentado todos os membros que fazem parte do projeto, assim como as permissões associadas\footnote{O gitlab permite que o dono do repositório atribua papéis para cada membro que vai fazer parte do projeto, mais informações são disponibilizadas em: https://softwarepublico.gov.br/gitlab/help/permissions/permissions}. Para adicionar um novo membro, basta acessar a opção *NEW PROJECT MEMBER*. Caso queira importar uma lista de outro projeto, selecione a opção *IMPORT MEMBERS*. +Na tela apresentada pela Figura \ref{fig:add_members}, o usuário deve informar o \textbf{nome do usuário} utilizado no SPB, assim como a permissão o qual ele vai ter no repositório. Depois disso, o usuário de salvar na opção \includegraphics[width=2.35cm]{figuras/botao_adduser.png} (Add users) e a pessoa irá fazer parte do projeto. -Na tela apresentada pela Figura X, o usuário deve informar o \textbf{nome do usuário} utilizado no SPB, assim como a permissão o qual ele vai ter no repositório. Depois disso, o usuário de salvar na opção *ADD USERS* e a pessoa irá fazer parte do projeto. +\graphicspath{{figuras/}} +\begin{figure}[htb!] + \centering + \includegraphics[width=1.1\textwidth]{add_members.png} + \caption{Adição de membros no projeto.} + \label{fig:add_members} +\end{figure} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -153,13 +236,25 @@ O Gitlab permite a criação de grupos para trabalho conjunto entre os usuários \subsubsection{Criação do grupo} -Para criar um grupo, o usuário deve localizar a opção "Desenvolvimento" no menu superior, logo após deve acessar a opção "Grupos", a Figura X representa o menu de Grupos. +Para criar um grupo, o usuário deve localizar a opção "Desenvolvimento" no menu superior, logo após deve acessar a opção "Grupos", a Figura \ref{fig:tela_grupos.png} representa os grupos o qual o usuário faz parte. -IMAGEM +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=1\textwidth]{tela_grupos.png} + \caption{Listagem de grupos que o usuário participa.} + \label{fig:tela_grupos.png} +\end{figure} -Após acessar o menu de Grupos, o usuário deve selecionar a opção "New Group", que é mostrado pela Figura X +Após acessar o menu de Grupos, o usuário deve selecionar a opção \includegraphics[width=2.35cm]{figuras/botao_newgroup.png}(New Group), que é mostrado pela Figura \ref{tela_grupos.png}. -IMAGEM +\graphicspath{{figuras/}} +\begin{figure}[htb!] + \centering + \includegraphics[width=1.1\textwidth]{create_group.png} + \caption{Tela para criação de membros no Gitlab.} + \label{tela_grupos.png} +\end{figure} O usuário deve preencher três campos, que são: @@ -169,7 +264,7 @@ O usuário deve preencher três campos, que são: \item \textbf{Group avatar -} Imagem de avatar do grupo. \end{itemize} -Após isso o grupo já está criado, e podem ser colocados projetos e membros para trabalho. O link para acesso o grupo (como mostrado em \ref{link:gitlab_grupo}) será: +Após isso o grupo já está criado, e podem ser colocados projetos e membros para trabalho. O link para acesso o grupo será: \begin{lstlisting}[caption={Link de disponibilização do grupo}, label=link:gitlab_grupo] https://softwarepublico.gov.br/gitlab/groups/NOMEDOGRUPO @@ -179,49 +274,108 @@ Observação: Ao criar o grupo do software a equipe de administração do portal \subsubsection{Adicionando membros e permissões} -Após criar e acessar o grupo, o usuário deve localizar no menu superior direito (abaixo do cabeçalho do SPB), a opção "Members". A Figura X ilustra a página do projeto com a opção "Members" destacada. - -IMAGEM - -Logo após, o Gitlab vai oferecer uma tela que contém todos os membros que fazem parte do grupo, o usuário deve acessar a opção Add members e preencher o campo com o nome do usuário que deseja adicionar. Além disso, o dono do grupo deve adicionar o tipo de permissão que o usuário pode ter. Essas permissões estão disponíveis (em inglês) nesse \href{http://doc.gitlab.com/ce/ci/permissions/README.html}{link}. +Após criar e acessar o grupo, o usuário deve localizar no menu superior direito (abaixo do cabeçalho do SPB), a opção "Members". A Figura \ref{tela_groupmembers.png} ilustra a página com os membros de um grupo. + +\graphicspath{{figuras/}} +\begin{figure}[htb!] + \centering + \includegraphics[width=1\textwidth]{tela_groupmembers.png} + \caption{Listagem de membros de um projeto.} + \label{tela_groupmembers.png} +\end{figure} + +Logo após, o usuário deve acessar a opção \includegraphics[width=2.9cm]{figuras/botao_addmember.png}(Add members). Como visto na Figura \ref{fig:tela_cadastromember.png}, é necessário preencher o campo com o nome do usuário que deseja adicionar (ou mesmo alterar a permissão de um membro no projeto), além disso, o dono do grupo deve adicionar o tipo de permissão que o usuário terá dentro do grupo. + +\graphicspath{{figuras/}} +\begin{figure}[htb!] + \centering + \includegraphics[width=1\textwidth]{tela_cadastromember.png} + \caption{Tela para criação de membros no Gitlab.} + \label{fig:tela_cadastromember.png} +\end{figure} + +\begin{tcolorbox}[colback=red!5,colframe=red!40!black,title=\textbf{Observação}] +As permissões para cada tipo de usuário estão disponíveis (em inglês) nesse \href{http://doc.gitlab.com/ce/ci/permissions/README.html}{link}. +\end{tcolorbox} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \subsection{Issue Tracker} +\label{sub:issue_tracker} +O Gitlab possui um sistema para controle de problemas, requisições, demandas, bugs, entre outros. Esse sistema que chamado de "\textit{issue tracker}", facilita o controle do desenvolvimento do projeto. + +Para acessar a páginas de \textit{issue} do seu projeto, o usuário deve acessar a página inicial do projeto e localizar a opção \textit{"Issues"} no menu superior do Gitlab. Será disponibilizada uma tela semelhante a ilustrada pela Figura \ref{fig:issue_tracker.png}. -O Gitlab possui um sistema para controle de problemas, requisições, demandas, bugs, entre outros. Esse sistema que é chamado de issue tracker, facilita o controle do desenvolvimento do projeto. +\graphicspath{{figuras/}} +\begin{figure}[htb!] + \centering + \includegraphics[width=1.05\textwidth]{issue_tracker.png} + \caption{Listagem de \textit{issues} de um projeto.} + \label{fig:issue_tracker.png} +\end{figure} -Para acessar a páginas de issue do seu projeto, o usuário deve acessar a página inicial do projeto e localizar a opção "Issues" no menu superior do Gitlab. Será disponibilizada uma tela semelhante a ilustrada pela Figura X. +\subsubsection{Cadastrando/Alterando uma nova issue} -IMAGEM +Acessando a tela principal de controle das issues, logo ao lado do campo de pesquisa de issues, existe uma opção chamada \includegraphics[width=2.9cm]{figuras/botao_newissue.png}(New Issue). Após selecionar a opção, uma tela de cadastro semelhante a ilustrada pela Figura \ref{fig:tela_cadastroissue.png} será apresentada. -\subsubsection{Cadastrando uma nova issue} +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.8\textwidth]{tela_cadastroissue.png} + \caption{Cadastro de \textit{issue} no projeto.} + \label{fig:tela_cadastroissue.png} +\end{figure} -Acessando a tela principal de controle das issues, logo ao lado do campo de pesquisa de issues, existe uma opção chamada *NEW ISSUES*. Após selecionar a opção, uma tela de cadastro semelhante a ilustrada pela Figura X será apresentada. +Nessa tela de cadastro o usuário deve informar \textit{(i)} o título problema/sugestão encontrada e \textit{(ii)} descrição do problema\footnote{nesse caso pode ser: passos para encontrar o problema, histórias de usuários, printscreens, fluxos de dados, imagens, entre outros conteúdos que possam ajudar o desenvolvedor visualizar o problema/sugestão}. -IMAGEM +Também é possível responsabilizar um membro do projeto através do campo \includegraphics[width=2.4cm]{figuras/label_assignto.png}(Assign to), que será a dona da issue. Essa pessoa receberá todas as notificações sobre a issue, além de poder filtrar as issues de acordo com o seu nome. -Nessa tela de cadastro o usuário deve informar o problema/sugestão encontrada +\subsubsection{Labels} -\subsubsection{Tags} +O Gitlab permite a categorização das demandas de acordo com Labels, isto é, uma issue quando aberta pode ser categorizada de acordo com o seu tipo, ferramenta, release que será ajustada, entre outros filtros. Essas tags podem ser definidos pelos desenvolvedores ou donos de repositórios. -Um issue tracker permite a categorização das demandas de acordo com tags, isto é, uma issue quando aberta pode ser categorizada de acordo com o seu tipo, ferramenta, release de ajuste, entre outros filtros, que podem ser definidos pelos desenvolvedores. +Para criar Labels, o usuário deve acessar o \hyperref[sub:issue_tracker]{Issue Tracker}. Existem duas formas de realizar o cadastro de labels, entre elas: + +\begin{itemize} + \item No menu de abas do issue tracker, há uma aba chamada Labels (conforme pode ser visto na Figura \ref{fig:menulateral_issues.png}) + \item No menu lateral há uma seção Labels. O botão \includegraphics[width=.3cm]{figuras/botao_labels.png}, pode ser utilizado para realizar a alterações nas labels. +\end{itemize} + +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.3\textwidth]{menulateral_issues.png} + \caption{Menu lateral contendo a seção labels.} + \label{fig:menulateral_issues.png} +\end{figure} \subsubsection{Milestones} -Milestones são marcos do projeto, ou seja, são objetivos que devem estar prontos em uma determinada data. Esses marcos podem ser um conjunto de várias issues, merge requests e participantes associados. +Milestones são marcos do projeto, ou seja, são objetivos que devem estar prontos em uma determinada data. Esses marcos podem ser um conjunto de várias issues, merge requests e participantes (equipe) que estão associados naquele marco. + +Para criação de Milestones o usuário deve acessar a página inicial do projeto, em seguida deve localizar a opção \hyperref[sub:issue_tracker]{Issue} no menu superior. Será apresentada a mesma tela da Figura X (ISSUES). Após isso, o usuário deve selecionar a aba \includegraphics[width=.3cm]{figuras/botao_createmilestone.png} (Milestones), abaixo do menu principal do Gitlab. -Para criação de milestones o usuário deve acessar a página inicial do projeto, em seguida deve localizar a opção Issues no menu superior. Será apresentada a mesma tela da Figura X (ISSUES). Após isso, o usuário deve selecionar a aba *MILESTONES*, abaixo do menu principal do Gitlab. +\graphicspath{{figuras/}} +\begin{figure}[H] + \centering + \includegraphics[width=.3\textwidth]{tela_criacaomilestone.png} + \caption{Menu lateral contendo a seção labels.} + \label{fig:menulateral_issues.png} +\end{figure} -IMAGEM +Após preencher o título, a descrição do marco, além da data de fechamento do marco, basta selecionar a opção \includegraphics[width=.3cm]{figuras/botao_milestone.png} (Create milestone). Após isso, basta selecionar as issues, além das pessoas que vão fazer parte desse marco. %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \subsection{Wiki} -O Gitlab também fornece uma wiki colaborativa, para que os desenvolvedores que não desejem colocar a documentação dentro do código fonte do software, possam colocar todos os artefatos relacionados a este software dentro do próprio sistema de wikis do Gitlab. +O Gitlab também fornece uma Wiki colaborativa para cada projeto. Essa wiki é utilizada como por exemplo, para que os desenvolvedores que não desejem versionar a documentação dentro do repositório do software, possam colocar todos os artefatos relacionados a este dentro da própria de wiki que o Gitlab fornece. + +Para acessar a Wiki do projeto, o usuário deve acessar a página inicial do projeto no Gitlab (repositório) e no menu superior direito (ao lado de "Settings"), deve acessar a opção Wiki. -Para acessar a wiki, o usuário deve acessar a página inicial do projeto no Gitlab (repositório) e no menu superior direito (ao lado de "Settings"), deve acessar a opção Wiki. +Caso o projeto não possua nenhuma página wiki, é criado uma primeira página chamada de home, que serve de página inicial da wiki. As demais páginas podem ser criadas através do botão \includegraphics[width=.3cm]{figuras/botao_newpage.png}. +\begin{tcolorbox}[colback=red!5,colframe=red!40!black,title=\textbf{Observação}] Existem 3 tipos de notações para escrita na Wiki do Gitlab, sendo a mais utilizada a Markdown. Toda a documentação e notação relacionada ao Markdown está disponível neste \href{https://softwarepublico.gov.br/gitlab/help/markdown/markdown}{link}. +\end{tcolorbox} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% diff --git a/capitulos/6-git.tex b/capitulos/6-git.tex index 1731ab7..829a13d 100644 --- a/capitulos/6-git.tex +++ b/capitulos/6-git.tex @@ -97,4 +97,4 @@ O tutorial abaixo é dedicado à alguns casos especiais em que seja necessário \section{Disponibilizando um projeto} -? +Tutorial de disponibilização de um software do zero. diff --git a/editaveis/abreviaturas.tex b/editaveis/abreviaturas.tex index 6b2b4e9..92fa4ec 100644 --- a/editaveis/abreviaturas.tex +++ b/editaveis/abreviaturas.tex @@ -1,20 +1,9 @@ \begin{siglas} %ORDEM ALFABETICA \item[AGPL] GNU Affero General Public License - \item[DC] Dublin Core \item[HTML] HyperText Markup Language \item[HTTP] Hipertext Transfer - \item[IBICT] Instituto Brasileiro de Informação em Ciência e Tecnologia \item[MVC] Model-View-Controller - \item[OAI] Open Archives Initiative - \item[OAI-PMH] Open Archives Initiative Protocol for Metadata Harvesting - \item[Participa.br] Portal de Participação Social - \item[PNUD] Programa das Nações Unidas para o Desenvolvimento - \item[RDF] Resource Description Framework - \item[Set] Grupos de assuntos relacionados - \item[SERPRO] Serviço Federal de Processamento de Dados - \item[SPARQL] SPARQL Protocol and RDF Query Language - \item[TDD] Test Driven Development \item[URI] Identificador de Endereços na Internet \item[XML] Extensible Markup Language. \end{siglas} diff --git a/editaveis/informacoes.tex b/editaveis/informacoes.tex index 64a2c42..b6eedcb 100644 --- a/editaveis/informacoes.tex +++ b/editaveis/informacoes.tex @@ -1,22 +1,9 @@ % Dados pessoais -\autor{Secretaria de Tecnologia da Informação} -\curso{Engenharia de Software} +\autor{Ministério do Planejamento, Orçamento e Gestão\\ +Secretaria de Tecnologia da Informação} % Dados do trabalho -\titulo{Manual do SPB -} +\titulo{MANUAL DE ADMINISTRAÇÃO DO SOFTWARE E COMUNIDADES DO PORTAL DO SOFTWARE PÚBLICO BRASILEIRO} \data{2016} -\palavraChaveUm{SPB} -\palavraChaveDois{Software Público} -% Dados da orientacao -\orientador{} -\coorientador{} -% Dados para a ficha catalográfica -\cdu{02:141:005.6} - -% Dados da aprovação do trabalho -\dataDaAprovacao{01/12/2014} -\membroConvidadoUm{} -\membroConvidadoDois{} diff --git a/figuras/add_members.png b/figuras/add_members.png new file mode 100644 index 0000000..dc4d679 Binary files /dev/null and b/figuras/add_members.png differ diff --git a/figuras/andamento_milestone.png b/figuras/andamento_milestone.png new file mode 100644 index 0000000..4c77be5 Binary files /dev/null and b/figuras/andamento_milestone.png differ diff --git a/figuras/botao_addmember.png b/figuras/botao_addmember.png new file mode 100644 index 0000000..1e0ff9c Binary files /dev/null and b/figuras/botao_addmember.png differ diff --git a/figuras/botao_adduser.png b/figuras/botao_adduser.png new file mode 100644 index 0000000..f251ca8 Binary files /dev/null and b/figuras/botao_adduser.png differ diff --git a/figuras/botao_closemilestone.png b/figuras/botao_closemilestone.png new file mode 100644 index 0000000..e178e2e Binary files /dev/null and b/figuras/botao_closemilestone.png differ diff --git a/figuras/botao_createmilestone.png b/figuras/botao_createmilestone.png new file mode 100644 index 0000000..8058b41 Binary files /dev/null and b/figuras/botao_createmilestone.png differ diff --git a/figuras/botao_importmembers.png b/figuras/botao_importmembers.png new file mode 100644 index 0000000..3859dd6 Binary files /dev/null and b/figuras/botao_importmembers.png differ diff --git a/figuras/botao_labels.png b/figuras/botao_labels.png new file mode 100644 index 0000000..2b810b1 Binary files /dev/null and b/figuras/botao_labels.png differ diff --git a/figuras/botao_members.png b/figuras/botao_members.png new file mode 100644 index 0000000..9437a81 Binary files /dev/null and b/figuras/botao_members.png differ diff --git a/figuras/botao_milestone.png b/figuras/botao_milestone.png new file mode 100644 index 0000000..544dbdd Binary files /dev/null and b/figuras/botao_milestone.png differ diff --git a/figuras/botao_newgroup.png b/figuras/botao_newgroup.png new file mode 100644 index 0000000..7ed8134 Binary files /dev/null and b/figuras/botao_newgroup.png differ diff --git a/figuras/botao_newissue.png b/figuras/botao_newissue.png new file mode 100644 index 0000000..977370c Binary files /dev/null and b/figuras/botao_newissue.png differ diff --git a/figuras/botao_newmember.png b/figuras/botao_newmember.png new file mode 100644 index 0000000..8589c01 Binary files /dev/null and b/figuras/botao_newmember.png differ diff --git a/figuras/botao_newpage.png b/figuras/botao_newpage.png new file mode 100644 index 0000000..92cd80f Binary files /dev/null and b/figuras/botao_newpage.png differ diff --git a/figuras/botao_removeproject.png b/figuras/botao_removeproject.png new file mode 100644 index 0000000..b91b425 Binary files /dev/null and b/figuras/botao_removeproject.png differ diff --git a/figuras/botao_sshkeys.png b/figuras/botao_sshkeys.png new file mode 100644 index 0000000..a453959 Binary files /dev/null and b/figuras/botao_sshkeys.png differ diff --git a/figuras/cadastro_eventos.png b/figuras/cadastro_eventos.png new file mode 100644 index 0000000..dfb8ff4 Binary files /dev/null and b/figuras/cadastro_eventos.png differ diff --git a/figuras/cadastro_milestone.png b/figuras/cadastro_milestone.png new file mode 100644 index 0000000..4db95a1 Binary files /dev/null and b/figuras/cadastro_milestone.png differ diff --git a/figuras/confirm_transfer.png b/figuras/confirm_transfer.png new file mode 100644 index 0000000..03c1c6f Binary files /dev/null and b/figuras/confirm_transfer.png differ diff --git a/figuras/create_group.png b/figuras/create_group.png new file mode 100644 index 0000000..6b83a6f Binary files /dev/null and b/figuras/create_group.png differ diff --git a/figuras/criacao_projeto.png b/figuras/criacao_projeto.png new file mode 100644 index 0000000..2c18e0d Binary files /dev/null and b/figuras/criacao_projeto.png differ diff --git a/figuras/default_label.png b/figuras/default_label.png new file mode 100644 index 0000000..6033e09 Binary files /dev/null and b/figuras/default_label.png differ diff --git a/figuras/issue_tracker.png b/figuras/issue_tracker.png new file mode 100644 index 0000000..88e4a79 Binary files /dev/null and b/figuras/issue_tracker.png differ diff --git a/figuras/label_assignto.png b/figuras/label_assignto.png new file mode 100644 index 0000000..c5dbc0c Binary files /dev/null and b/figuras/label_assignto.png differ diff --git a/figuras/menulateral_issues.png b/figuras/menulateral_issues.png new file mode 100644 index 0000000..f3846ca Binary files /dev/null and b/figuras/menulateral_issues.png differ diff --git a/figuras/menusup_gitlab.png b/figuras/menusup_gitlab.png new file mode 100644 index 0000000..503750b Binary files /dev/null and b/figuras/menusup_gitlab.png differ diff --git a/figuras/perfil_gitlab.png b/figuras/perfil_gitlab.png new file mode 100644 index 0000000..8f226d8 Binary files /dev/null and b/figuras/perfil_gitlab.png differ diff --git a/figuras/project_member.png b/figuras/project_member.png new file mode 100644 index 0000000..e5b259d Binary files /dev/null and b/figuras/project_member.png differ diff --git a/figuras/tela_cadastroissue.png b/figuras/tela_cadastroissue.png new file mode 100644 index 0000000..0b1011c Binary files /dev/null and b/figuras/tela_cadastroissue.png differ diff --git a/figuras/tela_cadastromember.png b/figuras/tela_cadastromember.png new file mode 100644 index 0000000..f746c24 Binary files /dev/null and b/figuras/tela_cadastromember.png differ diff --git a/figuras/tela_criacaomilestone.png b/figuras/tela_criacaomilestone.png new file mode 100644 index 0000000..f452ef6 Binary files /dev/null and b/figuras/tela_criacaomilestone.png differ diff --git a/figuras/tela_exclusaoprojeto.png b/figuras/tela_exclusaoprojeto.png new file mode 100644 index 0000000..7660d91 Binary files /dev/null and b/figuras/tela_exclusaoprojeto.png differ diff --git a/figuras/tela_groupmembers.png b/figuras/tela_groupmembers.png new file mode 100644 index 0000000..063ee4a Binary files /dev/null and b/figuras/tela_groupmembers.png differ diff --git a/figuras/tela_grupos.png b/figuras/tela_grupos.png new file mode 100644 index 0000000..3c4fc9a Binary files /dev/null and b/figuras/tela_grupos.png differ diff --git a/figuras/tela_members.png b/figuras/tela_members.png new file mode 100644 index 0000000..5db1937 Binary files /dev/null and b/figuras/tela_members.png differ diff --git a/figuras/tela_milestones.png b/figuras/tela_milestones.png new file mode 100644 index 0000000..5d3f47c Binary files /dev/null and b/figuras/tela_milestones.png differ diff --git a/figuras/tela_novapagwiki.png b/figuras/tela_novapagwiki.png new file mode 100644 index 0000000..4213ec8 Binary files /dev/null and b/figuras/tela_novapagwiki.png differ diff --git a/figuras/tela_projetogitlab.png b/figuras/tela_projetogitlab.png new file mode 100644 index 0000000..c954858 Binary files /dev/null and b/figuras/tela_projetogitlab.png differ diff --git a/figuras/tela_sshkeys.png b/figuras/tela_sshkeys.png new file mode 100644 index 0000000..6e13d5f Binary files /dev/null and b/figuras/tela_sshkeys.png differ diff --git a/figuras/transfer_project.png b/figuras/transfer_project.png new file mode 100644 index 0000000..451ad5f Binary files /dev/null and b/figuras/transfer_project.png differ diff --git a/fixos/informacoes.tex b/fixos/informacoes.tex index f6a64ce..a58337a 100644 --- a/fixos/informacoes.tex +++ b/fixos/informacoes.tex @@ -1,6 +1,4 @@ \local{Brasília, DF} -\instituicao{% - Ministério do Planejamento -} -\tipotrabalho{Trabalho de Conclusão de Curso} -\preambulo{Manual de utilização do Novo Portal do Software Público.} +%\instituicao{Ministério do Planejamento, Orçamento e Gestão} +\tipotrabalho{Manual de utilização do Novo Portal do Software Público Brasileiro.} +\preambulo{} diff --git a/fixos/novosComandos.tex b/fixos/novosComandos.tex index 813d6d3..a61f470 100644 --- a/fixos/novosComandos.tex +++ b/fixos/novosComandos.tex @@ -1,60 +1,3 @@ -\newcommand{\curso}[1]{\def\imprimircurso{#1}} - -\newcommand{\palavraChaveUm}[1]{\def\imprimirpalavrachaveum{#1}} -\newcommand{\palavraChaveDois}[1]{\def\imprimirpalavrachavedois{#1}} - -\newcommand{\cdu}[1]{\def\nomecdu{#1}} -\newcommand{\dataDaAprovacao}[1]{\def\imprimirdatadaaprovacao{#1}} - -\newcommand{\membroConvidadoUm}[1]{\def\imprimirmembroconvidadoum{#1}} -\newcommand{\membroConvidadoDois}[1]{\def\imprimirmembroconvidadodois{#1}} - -\newcommand\BackgroundPic{% - \put(0,0){% - \parbox[b][\paperheight]{\paperwidth}{% - \vfill - \centering - \includegraphics[width=\paperwidth,height=\paperheight,% - keepaspectratio]{figuras/capa.eps}% - \vfill - } - } -} - -\renewcommand{\imprimircapa}{% - \begin{capa}% - \center - \AddToShipoutPicture*{\BackgroundPic} - -% \begin{huge} -% \textbf{\textsc{Trabalho de Conclusão de Curso}} -% \end{huge} - - \vspace*{2.7in} - {\textbf{\large\imprimirinstituicao}} - \par - {\textbf{\large\imprimircurso}} - - \vspace{0.5in} - - {\ABNTEXchapterfont\bfseries\LARGE\imprimirtitulo} - \vspace*{\fill} - - \begin{flushright} - \textbf{{\large{Autor: \imprimirautor}}} - \par - \textbf{{\large{Orientador: \imprimirorientador}}} - \end{flushright} - - \vspace*{0.2in} - \textbf{{\large\imprimirlocal}} - \par - \textbf{{\large\imprimirdata}} - - \vspace*{2.2in} - \end{capa} -} - \newcommand{\thickhline}{% \noalign {\hrule height 2pt}% } diff --git a/manual.tex b/manual.tex index 38ae06c..9ed6781 100644 --- a/manual.tex +++ b/manual.tex @@ -8,12 +8,9 @@ \begin{document} -\frenchspacing -%\imprimircapa +\frenchspacing \imprimirfolhaderosto* -%\input{fixos/fichaCatalografica} -%\input{editaveis/resumo} \input{fixos/listasAutomaticas} \input{editaveis/abreviaturas} \input{fixos/indiceAutomatico} @@ -31,8 +28,7 @@ \input{capitulos/6-git} \input{capitulos/7-mezuro} -\bookmarksetup{startatroot} - +%\bookmarksetup{startatroot} \postextual \bibliography{bibliografia} \printindex -- libgit2 0.21.2