LaTeX 워크 플로우 변경 :

git + latex 워크 플로우를 효율적으로 관리하기위한 첫 번째 단계는 LaTeX 습관을 약간 변경하는 것입니다.

• 우선 각 문장을 별도의 줄에 쓰십시오 . Git은 버전 제어 소스 코드로 작성되었으며, 각 라인은 고유하고 특정 목적을 가지고 있습니다. LaTeX로 문서를 작성할 때 종종 단락의 관점에서 생각하고 자유롭게 흐르는 문서로 작성합니다. 그러나 git에서 단락의 단일 단어에 대한 변경 사항은 전체 단락에 대한 변경 사항으로 기록됩니다.

  한 가지 해결책은 사용하는 것입니다 git diff --color-words( 예를 보여주는 유사한 질문에 대한 답변 참조 ). 그러나 별도의 줄로 나누는 것이 훨씬 더 나은 옵션이라는 점을 강조해야합니다. 병합 충돌을 최소화하는 것으로 나타났습니다.

• 코드 diff를 살펴 보려면 git의 기본 diff를 사용하십시오. 두 개의 임의 커밋 (버전)의 차이점을 확인하려면 sha각 커밋 의 s를 사용하면됩니다. 자세한 내용 과이 질문 은 설명서 를 참조하십시오

  다른 한편으로, 당신이 당신의 형식화 된 출력 의 차이점을보고 싶다면 , latexdiff이것은 두 가지 라텍스 파일을 가져 와서 pdf로 깔끔한 diffed 출력을 생성하는 훌륭한 유틸리티 (perl로 작성)를 사용하십시오 ( 이미지 소스 ) :

  

  git-latexdiff를 사용하여 하나의 명령으로 git및 latexdiff( latexpand필요한 경우 플러스) 결합 할 수 있습니다 (예 : 작업 트리git latexdiff HEAD^ 와 마지막 커밋 사이의 차이를 보려는 경우).

• 라텍스로 긴 문서를 작성하는 경우 다른 챕터를 자신의 파일로 분할 하고 \include{file}명령을 사용하여 기본 파일에서 호출하는 것이 좋습니다 . 이런 방식으로 작업의 현지화 된 부분을 편집하는 것이 더 쉬우 며, 큰 장의 로그에서 파악하지 않고 각 장의 변경 사항을 알기 때문에 버전 관리가 더 쉽습니다. 파일.

git을 효율적으로 사용 :

• 가지를 사용하십시오! . 내가 줄 수있는 더 좋은 조언은 없을 것입니다. 나는 브랜치가 작품의 “다른 아이디어”나 텍스트의 “다른 아이디어”를 추적하는데 매우 도움이된다는 것을 알게되었다. master분기, 경우 모든 지점의, 상태, 즉 “를 게시 할 준비가”당신이 그것에 당신의 이름을 넣어 의향이 있다고 존재하는 경우, 그것은 마스터 지점해야 가장 전류, 작품의 주요 신체해야합니다.

  당신이 대학원생이라면 지점도 매우 도움이됩니다. 모든 대학원생이 증명 하듯이, 고문은 많은 수정을해야하는데, 대부분 귀하가 동의하지 않습니다. 그러나 나중에 토론 후에 되돌려 놓더라도 당분간 변경해야 할 수도 있습니다 . 따라서 이러한 경우 새 브랜치 advisor를 만들고 자신의 개발 브랜치를 유지하면서 원하는대로 변경할 수 있습니다 . 그런 다음 두 가지와 체리 선택을 병합하여 필요한 것을 선택할 수 있습니다.

• 또한 각 섹션을 다른 브랜치로 나누고 현재 브랜치에 해당하는 섹션에만 집중하는 것이 좋습니다. 새로운 커밋을 만들 때 브랜치를 생성하거나 초기 커밋을 할 때 더미 섹션을 만듭니다 (실제로 선택). 지점에 없을 때 다른 섹션 (예 : 3)을 편집해야한다는 충동에 저항하십시오. 편집 해야하는 경우이 것을 커밋 한 다음 분기하기 전에 다른 것을 체크 아웃하십시오. 섹션의 히스토리를 자체 분기에 유지하고 (섹션에서) 일부 섹션의 나이를 한눈에 알 수 있기 때문에 이것이 매우 유용합니다. 어쩌면 당신은 섹션 5에 섹션 5를 조정 해야하는 자료를 추가했을 것입니다 … 물론, 이것들은 모든 경우에주의 깊게 읽는 동안 관찰 될 것이지만, 이것을 한눈에 보는 것이 도움이 될 수 있습니다. 내가 변속 기어

  다음은 내 지점의 예이며 최근 논문에서 병합합니다 (OS X에서는 SourceTree를 사용하고 Linux에서는 명령 줄에서 git을 사용합니다). 당신은 아마 내가 세계에서 가장 빈번한 커미터가 아니거나 항상 유용한 의견을 남기지 않는다는 것을 알 것입니다. 그러나 이것이 좋은 습관을 따르지 않는 이유는 아닙니다. 주요 테이크 아웃 메시지는 지점에서 일하는 것이 도움이된다는 것입니다. 내 생각, 아이디어 및 개발은 비선형으로 진행되지만 지점을 통해 추적하고 추적하면 만족할 때 병합 할 수 있습니다 (나중에 삭제 된 다른 지점도있었습니다). 커밋에 의미가있는 경우 커밋에 “태그”를 붙일 수도 있습니다 (예 : 저널에 초기 제출, 수정 된 제출 등). 여기에 “버전 1″이라는 태그가 붙어 있습니다. 현재 버전은 초안입니다. 나무는 일주일을 나타냅니다

  

• 또 다른 유용한 작업은 문서 전체를 변경 (예 : 모든 곳 으로 변경) \alpha하여 \beta커밋하는 것입니다. 그렇게하면 다른 것과 함께 롤백하지 않고도 변경 사항을 되돌릴 수 있습니다 (git를 사용 하여이 작업을 수행 할 수있는 방법이 있지만 피할 수 있다면 어떨까요?). 프리앰블에 추가 할 때도 마찬가지입니다.

• 원격 저장소를 사용하고 정기적으로 변경 사항을 업스트림으로 푸시하십시오. github 및 bitbucket과 같은 무료 서비스 제공 업체 (후자는 무료 계정으로 개인 저장소를 만들 수 있음)를 사용하여 git / mercurial로 작업하는 경우 이들을 사용하지 않을 이유가 없습니다. 최소한 라텍스 파일과 다른 컴퓨터에서 남은 곳에서 계속 편집 할 수있는 서비스에 대한 보조 백업 (기본 백업이 있기를 바랍니다)으로 고려하십시오.

답변

function git-latexdiff {
    if [[ $# != 2 ]];
    then
        printf "\tusage: git-latexdiff <file> <back-revision>  \n";
    elif [[ $2 -lt 0 ]];
    then
        printf "\t<Back-revision> must be positive\n";
    else
        dire=$(dirname $PWD/$1);
        based=$(git rev-parse --show-toplevel);
        git show HEAD~$2:$(echo $dire| sed 's!'$(echo $based)'/!!')/$1 > $1_diff.tmp;
        latexdiff $1 $1_diff.tmp > $1_diff.tex;
        pdflatex $1_diff.tex;
        okular $1_diff.pdf;
        rm $1_diff*;
    fi;
}