cbx33 / gitt Goto Github PK
View Code? Open in Web Editor NEWGit In the Trenches
Home Page: http://cbx33.github.com/gitt
Git In the Trenches
Home Page: http://cbx33.github.com/gitt
I'd like to add an HTML build to my autobuilder, but I can't quite figure it out entirely. A few possible issues/bugs:
make site
and make web
both exist, and are different - is this a bug?I've addressed these in an improved makefile - will be pull requested soon.
Also...
site
folder, the only link that works is the "read now", and the "slide1" image is missing.I've uploaded the "site" directory to my server space from the autobuilder for now - you're welcome to take a look and see if there's some improvement that can be made.
http://www.hci.iastate.edu/~rpavlik/doxygen/git-in-the-trenches/site/
I think you have a spelling issue in afterhoures1.tex
In line 45 there is standing "[...]On June 16th, the relese of the Linux kernel[...]". Shouldn't it be release instead of relese?
~ looks odd in code sections of dev design branch
In Chapter 1, the source reads "This is all due to the fact that Git does 99% of all of its operations locally." But the generated HTML truncates at that token, leaving the text as "This is all due to the fact that Git does 99When a repository is cloned..." I trust that the other outputs correctly display the "99%" as desired, so it may be something in your TeX-to-HTML converter.
I downloaded the .mobi version, and installed on Kindle. There seems to be a problem with the flow. I will start a chapter, for instance, Chapter 1, page through it and then suddenly it pauses for a long time, then skips to the end of the book. The problem seems to be the callback sections. When I have more time I'll go back and make notice of where the skip-ahead occurs; it isn't just in one chapter, but at spots throughout the book.
After install latex dependencies on Linux Mint Helena - x64 Edition, I can't make pdf.
After some processing shell execution stopped on prompt.
pdfTeX warning: pdflatex (file ./images/fcover-new.pdf): PDF inclusion: Page Gr
oup detected which pdfTeX can't handle. Ignoring it.
{/var/lib/texmf/fonts/map/pdftex/updmap/pdftex.map}>] 2
(/usr/share/texmf-texlive/tex/latex/microtype/mt-cmr.cfg)
(/usr/share/texmf/tex/latex/lm/omllmm.fd)
(/usr/share/texmf/tex/latex/lm/omslmsy.fd)
(/usr/share/texmf/tex/latex/lm/omxlmex.fd) [3] [4] (./gitt.toc [5] [6] [7]
Overfull \hbox (1.5877pt too wide) detected at line 110
\OT1/lmss/bx/n/12 117
Overfull \hbox (1.5877pt too wide) detected at line 113
\OT1/lmss/bx/n/12 127
Overfull \hbox (1.5877pt too wide) detected at line 127
\OT1/lmss/bx/n/12 147
Overfull \hbox (1.5877pt too wide) detected at line 132
\OT1/lmss/bx/n/12 151
[8]
Overfull \hbox (1.5877pt too wide) detected at line 149
\OT1/lmss/bx/n/12 173
Overfull \hbox (1.5877pt too wide) detected at line 153
\OT1/lmss/bx/n/12 181
Overfull \hbox (1.5877pt too wide) detected at line 166
\OT1/lmss/bx/n/12 201
Overfull \hbox (1.5877pt too wide) detected at line 169
\OT1/lmss/bx/n/12 203
) [9] (./intro.tex [10]
! Undefined control sequence.
\memUChead
{\f@rhdr }
l.3 \chapter{Introduction}
?
http://cbx33.github.com/gitt/chap7-6.html reads "git rebase --onto master ". Do you mean "it rebase --onto "?
$ symbol looks odd in code sections in dev branch design
Nasty border in IE on image links
pg39 has a large black border on the right of the callout box in the font-up branch
Can chapter and section and subsection headings be bolded?
In section titles and page headers, the apostrophes and and double quotes are missing.
The convention for arrows is from pointer to pointed.
It is OK for commit -> tree -> blob, but in commit history graphs the arrows are in 'time' direction C1 -> C2 -> C3.
Shouldn't it be in C1 <- C2 <- C3 direction, like in progit book and to be closer to a real DAG (http://stackoverflow.com/questions/2676302/arrows-direction-in-progit-book) ?
web H3 needs padding
On Mac OS X (Yosemite at least), one must use man git-log
. At first I thought this was a bug in your book, but man git log
does work on Linux. It might be handy to mention the difference or swap it to man git-log
since Linux (Debian 8.1 at least) supports both styles.
Is there a nice easy way to build html from this? That I could style with CSS? Or should I just write my own converter? latex2html didn't seem to do a good job last time. Part of it was because of the .pdf images. I could make it so that it looks for .png whenever it sees .pdf. In a python script or something, but would prefer something a little more automatic.
Funny lines all over print version font cover
Seemingly most non-trench, non-code sections that contain ligatures are missing from the print version
Any idea what's causing this?
> make pdflatex gitt.tex This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4) entering extended mode (./gitt.tex LaTeX2e <2003/12/01> Babel and hyphenation patterns for american, french, german, ngerman, b ahasa, basque, bulgarian, catalan, croatian, czech, danish, dutch, esperanto, e stonian, finnish, greek, icelandic, irish, italian, latin, magyar, norsk, polis h, portuges, romanian, russian, serbian, slovak, slovene, spanish, swedish, tur kish, ukrainian, nohyphenation, loaded. (/usr/share/texmf/tex/latex/memoir/memoir.cls Document Class: memoir 2004/04/05 v1.61 configurable document class (/usr/share/texmf/tex/latex/memoir/mem12.clo) (/usr/share/texmf/tex/latex/memoir/mempatch.sty)) ****************************************************** Stock height and width: 597.50787pt by 421.10078pt Top and edge trims: 0.0pt and 0.0pt Page height and width: 597.50787pt by 421.10078pt Text height and width: 490.5pt by 305.0pt Spine and edge margins: 61.45805pt and 54.34486pt Upper and lower margins: 54.34486pt and 52.66301pt Headheight and headsep: 14.0pt and 19.8738pt Footskip: 30.0pt Columnsep and columnseprule: 10.0pt and 0.0pt Marginparsep and marginparwidth: 7.0pt and 51.0pt ****************************************************** (/usr/share/texmf/tex/latex/graphics/graphicx.sty (/usr/share/texmf/tex/latex/graphics/keyval.sty) (/usr/share/texmf/tex/latex/graphics/graphics.sty (/usr/share/texmf/tex/latex/graphics/trig.sty) (/usr/share/texmf/tex/latex/graphics/graphics.cfg) (/usr/share/texmf/tex/latex/graphics/pdftex.def))) (/usr/share/texmf/tex/latex/float/float.sty ! LaTeX Error: Command \newfloat already defined. Or name \end... illegal, see p.192 of the manual. See the LaTeX manual or LaTeX Companion for explanation. Type H for immediate help. ... l.68 {}}} ?
There is a nice cover for GITT in images/source/fcover.pdf.
The current way to include this in the output is with the makefile, but this breaks the links and is unnecessary because LaTeX can handle this also.
There are multiple ways how to include it:
I prefer the first or the second way but the first at most.
I've added a job to my continuous integration server to poll the repo for changes hourly and upload the PDF to a web server here: http://www.hci.iastate.edu/~rpavlik/doxygen/git-in-the-trenches/
I'm wondering if you would want to link to that, or if there's some other place I can set up my build system (Jenkins) to send it to - I can send stuff using at least SCP or Git, and possibly other methods, whatever works best for you. Let me know!
On the begining page of Week 1 the page numbers are at the bottom middle of the page. In the following pages the numbers are on the top left or top right corner.
I think for a more consistent look of the book the bottom numbers should move to the top corners.
PS: Nice new testing design
Make it so we can choose fonts easier
Possibly make the main font serif, and then make the trenches font match
In the Introduction the last line says "With the introduction over, let’s first go through a quick setup guide and then find out why Tamagoyaki Inc even need a version control system in the first place."
This may be nit picking but shouldn't it say "even needs a version control system in the first place."?
Need some negatives in history for git :)
index starts on left hand page - should be on right
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.