Copyleft/guide
6
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Copyleft and the GPL: A Comprehensive Tutorial and Guide
738 commits 1 branch 0 tags 4.8 MiB
TeX 95.4%
Makefile 3.1%
CSS 0.7%
JavaScript 0.6%
Shell 0.2%
Find a file
Bradley M. Kuhn 476a42bf0d In-page anchor links vs. bootstrap's fixed navbar 
@keynote2k was the first to point out that the in-page anchor links in
the Guide failed to function properly, due to Bootstrap's fixed navbar.

This mixed solution of CSS and Javascript is the best solution I've been
able to come up with for the problem.  The CSS solution is obviously
preferable, and is used herein for those anchor id attributes in the
Guide that have no href of their own.

Due to problems with using a pure CSS solution where the anchor includes
both an href and a id attribute.  The Javascript solution is specific
for those cases.  I took care not to have them both happen at once, as
they would undoubtedly conflict.

I did a inordinate amount of research about this issue.  Bootstrap's own
page about the fixed navbar:
   http://getbootstrap.com/examples/navbar-fixed-top/

doesn't discuss this issue at all, but there is a bug in Booststrap's
 bugtracker:
     https://github.com/twitter/bootstrap/issues/1768

which discusses the issue.  (However, I don't understand why that bug is
closed, since none of the solutions I implement herein truly solve it).

The most useful page I found regarding this issue is this one:
  http://nicolasgallagher.com/jump-links-and-viewport-positioning/demo

which offers several pure CCS solutions (each with drawbacks and
advantages).  Unfortunately, none of those solutions consider the
question of anchor links that have both href and id attributes, and none
of them work properly in that situation.
2014-11-16 10:23:08 -05:00
Case-Study-Ethics Remove unnecessary versions and formats of the case-studiess tutorial material. 2014-02-16 18:00:49 -05:00
css In-page anchor links vs. bootstrap's fixed navbar 2014-11-16 10:23:08 -05:00
enforcement-case-studies_log-output Add BusyBox output/kernel log; update study FIXME 2014-11-08 12:16:45 -05:00
GPL-Business ChangeLog is a deprecated method for tracking changes, use git log now. 2014-02-16 17:17:35 -05:00
GPL-LGPL Remove deprecated LaTeX formatting scripts and commands. 2014-02-16 17:15:34 -05:00
js In-page anchor links vs. bootstrap's fixed navbar 2014-11-16 10:23:08 -05:00
presentations/1hr-GPL Make the title fit. 2014-03-24 10:51:29 -04:00
.gitignore Other files that should be git ignore'd. 2014-11-06 16:19:57 -05:00
CC-By-SA-4.0.txt Creative Commons had trailing whitespace on this line. 2014-02-15 17:39:34 -05:00
compliance-guide.tex Spell check and correction. 2014-11-13 13:05:33 -05:00
comprehensive-gpl-guide.tex Correct URL: s/gpl-compliance-tools/copyleft-org/ 2014-11-13 13:32:29 -05:00
enforcement-case-studies.tex Denver should be listed in authors section. 2014-11-13 13:31:19 -05:00
gpl-lgpl.tex Spell check and correction. 2014-11-13 13:05:33 -05:00
license-texts.tex Incorporate copyleft defn from copyleft.org site 2014-11-12 07:18:59 -05:00
Makefile Build by chapter only. 2014-11-07 02:13:36 -05:00
no-numbers-on-table-of-contents.tex Move stuff to make the ToC with now ...'s and numbers to another file, 2014-02-20 13:37:23 -05:00
README.md Commands to install right Debian packages. 2014-11-06 13:21:39 -05:00
tex4ht.usr Shorten the menu item further: s/page/pg/ 2014-11-07 10:25:31 -05:00
TODO.md Note down idea for copyleft.guide that I just had. 2014-11-07 13:18:15 -05:00
webhacks.cfg Properly format and place title everywhere. 2014-11-07 11:35:13 -05:00

README.md

Copyleft and GPL Tutorial Materials

This repository contains various tutorial materials regarding the suite of GNU General Public Licenses and copyleft (as applied to software).

The primary item of interest is an omnibus book on copyleft that is built from the comprehensive-GPL-guide.tex file.

You can build this project with the following command:

$ make

HTML output will be in the public_html directory and a PDF file will be in comprehensive-gpl-guide.pdf.

You may need to first install texlive, tex4ht and a few other things. On Debian-based systems, this command may work as root:

# aptitude install texlive-full make tex4ht

You can also download a prebuilt PDF file.

Note the canonical repository for this project is on gitorious. Copies of this repository on other sites is for informational and backup purposes only.

Contributing

Patches to this project are welcome. Please submit a merge request on Gitorious. If you cannot use that, you can email patches directly to Bradley. You can find his email address in the commit logs.