COPPE-UFRJ / CoppeTeX

A LaTeX toolkit for writing thesis and dissertations at COPPE/UFRJ
GNU General Public License v3.0
60 stars 18 forks source link

Regra para colaborações externas #12

Open xexeo opened 4 years ago

xexeo commented 4 years ago

Basicamente a regra do GitHub é meio padrão.

O colaborador faz um fork. O colaborador mexe no que quiser. O colaborador faz um pull request.

Acho que podemos só explicar isso com um passo a passo simples, talvez apontar para uma documentação oficial.

O que seria interessante é a gente conseguir uma regra para facilitar que modificações seria todo o estilo CoppeTeX ser padrão em um diretório.

O raciocínio é o seguinte.

Hoje quem usa o estilo coloca tudo no raiz. Faz uma confusão com os seus próprios arquivos. Se ele faz alguma modificação, ou soma algo interessante, há um problema de voltar para o git, precisa ser um pouco mais esperto que o usuário médio.

Então a proposta é quem for usar o CoppeTex já colocaria ele em um diretório fixo. Tem que mudar um comando no arquivo, que é o Provide Package para incluir no nome do pacote fornecido o diretório (Isso é uma boa coisa????).

\ProvidesPackage{Comandos/pgf-pie}[2011/10/02 v0.2 Some LaTeX macros for pie chart by using PGF/Tikz package.]

Isso é para evitar um warning que seu estilo não é bem o estilo que você queria, realmente pode haver uma solução melhor.

Então, se alguém modificasse os arquivos do CoppeTeX, fazer a comparação e o Pull seria mais fácil para ele.

A outra vantagem é que o usuário comum não ficaria cheio de arquivos no seu diretório raiz.

Acho que podem existir soluções melhores

vicentehelano commented 4 years ago

Nesse caso, o padrão do CTAN seria instalar os arquivos da classe em um diretório TEXMFHOME:

CLSDIR=$(TEXMFHOME)/tex/latex/coppe BSTDIR=$(TEXMFHOME)/bibtex/bst/coppe ISTDIR=$(TEXMFHOME)/makeindex/coppe DOCDIR=$(TEXMFHOME)/doc/latex/coppe

Com isso, o usuário teria o template limpo, somente com os arquivos dele.

O mais fácil para o usuário seria submetermos o CoppeTeX ao CTAN, para inclusão nas distribuições de LaTeX. (https://ctan.org/upload) Outro modo seria prover algum tipo de instalador.

O que acha?

Um abraço, Vicente Helano.

Em seg., 17 de fev. de 2020 às 11:16, Geraldo Xexeo < notifications@github.com> escreveu:

Basicamente a regra do GitHub é meio padrão.

O colaborador faz um fork. O colaborador mexe no que quiser. O colaborador faz um pull request.

Acho que podemos só explicar isso com um passo a passo simples, talvez apontar para uma documentação oficial.

O que seria interessante é a gente conseguir uma regra para facilitar que modificações seria todo o estilo CoppeTeX ser padrão em um diretório.

O raciocínio é o seguinte.

Hoje quem usa o estilo coloca tudo no raiz. Faz uma confusão com os seus próprios arquivos. Se ele faz alguma modificação, ou soma algo interessante, há um problema de voltar para o git, precisa ser um pouco mais esperto que o usuário médio.

Então a proposta é quem for usar o CoppeTex já colocaria ele em um diretório fixo. Tem que mudar um comando no arquivo, que é o Provide Package para incluir no nome do pacote fornecido o diretório (Isso é uma boa coisa????).

\ProvidesPackage{Comandos/pgf-pie}[2011/10/02 v0.2 Some LaTeX macros for pie chart by using PGF/Tikz package.]

Isso é para evitar um warning que seu estilo não é bem o estilo que você queria, realmente pode haver uma solução melhor.

Então, se alguém modificasse os arquivos do CoppeTeX, fazer a comparação e o Pull seria mais fácil para ele.

A outra vantagem é que o usuário comum não ficaria cheio de arquivos no seu diretório raiz.

Acho que podem existir soluções melhores

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/COPPE-UFRJ/CoppeTeX/issues/12?email_source=notifications&email_token=AAN724Q4XXE2NLXTS2WD6X3RDKL5NA5CNFSM4KWSRMVKYY3PNVWWK3TUL52HS4DFUVEXG43VMWVGG33NNVSW45C7NFSM4IOBPPMQ, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAN724QEQENQSSXPMNCPTN3RDKL5NANCNFSM4KWSRMVA .

xexeo commented 4 years ago

CTAN na certa, melhor opção e "chique demais". Creio que depois de submetido, não teríamos problema em atualizar, certo?

Abraços, Xexéo

vicentehelano commented 4 years ago

Exatamente! Ficaria tudo mais transparente. Submetemos uma versão agora ou esperamos a correção do Mengeli para o luatex?

Em seg., 17 de fev. de 2020 às 22:45, Geraldo Xexeo < notifications@github.com> escreveu:

CTAN na certa, melhor opção e "chique demais". Creio que depois de submetido, não teríamos problema em atualizar, certo?

Abraços, Xexéo

— You are receiving this because you commented. Reply to this email directly, view it on GitHub https://github.com/COPPE-UFRJ/CoppeTeX/issues/12?email_source=notifications&email_token=AAN724SYKVGN6MHKZBIZVP3RDM4TVA5CNFSM4KWSRMVKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOEMAH3WA#issuecomment-587234776, or unsubscribe https://github.com/notifications/unsubscribe-auth/AAN724XIH6TTEMCKTW43TWLRDM4TVANCNFSM4KWSRMVA .