Numerous changes and updates to site content, layout, menu, structure.

bookshelf
Gutenberg back end service account 2020-01-01 12:51:55 -05:00
parent 5ce78c4220
commit 639e61a009
22 changed files with 1065 additions and 167 deletions

View File

@ -49,5 +49,5 @@ destination: /public/vhost/g/gutenberg/dev/html/
timezone: America/New_York timezone: America/New_York
encoding: utf-8 # default encoding: utf-8 # default
incremental: TRUE # doesn't seem to work... all files are being built incremental: TRUE # doesn't seem to work... all files are being built
keep_files: [.htaccess,cache,robots.txt,google3c00b5891470e2e3.html,catalog,browse] keep_files: [.htaccess,cache,robots.txt,google3c00b5891470e2e3.html,catalog,browse,dirs]

View File

@ -1,6 +1,6 @@
<ul> <ul>
<li> <li>
<a href="/policy/privacy_policy.html" title="Privacy policy">Privacy policy</a> <a href="/policy/privacy_policy.html" title="Privacy Policy">Privacy policy</a>
</li> </li>
<li> <li>
<a href="/about/" title="About Project Gutenberg">About Project Gutenberg</a> <a href="/about/" title="About Project Gutenberg">About Project Gutenberg</a>

View File

@ -11,42 +11,47 @@
<li><a href="/about/">About</a> <li><a href="/about/">About</a>
<ul class="hidden"> <ul class="hidden">
<li><a href="/about/">About Project Gutenberg &rarr;</a></li> <li><a href="/about/">About Project Gutenberg &rarr;</a></li>
<li><a href="/policy/collection_development.html">Collection development</a></li> <li><a href="/policy/collection_development.html">Collection Development</a></li>
<li><a href="/about/contact_information.html">Contact Us</a></li> <li><a href="/about/contact_information.html">Contact Us</a></li>
<li><a href="/background/">History and philosophy &rarr;</a></li> <li><a href="/about/background/">History and Philosophy &rarr;</a></li>
<li><a href="/policy/linking.html">Linking policy</a></li> <li><a href="/policy/permission.html">Permissions and License</a></li>
<li><a href="/policy/permission.html">Permissions and license</a></li> <li><a href="/policy/privacy_policy.html">Privacy Policy</a></li>
<li><a href="/policy/privacy_policy.html">Privacy policy</a></li> <li><a href="/policy/terms_of_use.html">Terms of Use</a></li>
<li><a href="/policy/terms_of_use.html">Terms of use</a></li>
</ul> </ul>
</li> </li>
<li><a href="/help/">Help</a> <li><a href="/help/">Help</a>
<ul class="hidden"> <ul class="hidden">
<li><a href="/about/">About Project Gutenberg &rarr;</a></li> <li><a href="/help/">All help topics &rarr;</a></li>
<li><a href="/policy/">Policy &rarr;</a></li> <li><a href="/help/copyright.html">Copyright Procedures</a></li>
<li><a href="/help/copyright.html">Copyright How-To</a></li>
<li><a href="/help/errata.html">Errata, Fixes and Bug Reports</a></li> <li><a href="/help/errata.html">Errata, Fixes and Bug Reports</a></li>
<li><a href="/help/file_formats.html">File Formats</a></li> <li><a href="/help/file_formats.html">File Formats</a></li>
<li><a href="/help/faq.html">Frequently Asked Questions</a></li> <li><a href="/help/faq.html">Frequently Asked Questions</a></li>
<li><a href="/help/mirroring.html">Mirroring How-To</a></li> <li><a href="/policy/">Policies &rarr;</a></li>
<li><a href="/help/no_sweat_copyright.html">No Sweat of the Brow copyright</a></li> <li><a href="/help/public_domain_ebook_submission.html">Public Domain eBook Submission</a></li>
<li><a href="/policy/permission.html">Permission How-To</a></li> <li><a href="/help/submitting_your_own_work.html">Submitting Your Own Work</a></li>
<li><a href="/help/public_domain_ebook_submission.html">Public Domain eBook Submission How-To</a></li> <li><a href="/help/mobile.html">Tablets, Phones and eReaders</a></li>
<li><a href="/help/submitting_your_own_work.html">Submitting Your Own Work How-To</a></li>
<li><a href="/help/mobile.html">Tablets, Phones and eReaders How-To</a></li>
<li><a href="/attic/">The Attic &rarr;</a></li> <li><a href="/attic/">The Attic &rarr;</a></li>
</ul> </ul>
</li> </li>
<li><a href="/ebooks/">Search</a></li> <li><a href="/ebooks/">Search</a>
<ul class="hidden">
<li><a href="/ebooks/">Book Search</a></li>
<li><a href="/ebooks/bookshelf/">Bookshelves</a></li>
<li><a href="/browse">Browse</a></li>
<li><a href="/ebooks/search/?sort_order=downloads">Frequently Downloaded</a></li>
<li><a href="/ebooks/offline_catalogs.html">Offline Catalogs</a></li>
<li><a href="/ebooks/search/?query=&submit_search=Search&sort_order=release_date">Recently Added</a></li>
</ul>
</li>
<li><a href="/donate/">Donate</a></li> <li><a href="/donate/">Donate</a></li>
</ul> </ul>
<div class="searchbox"> <div class="searchbox">
<form method="get" action="/ebooks/search/" accept-charset="utf-8" enctype="multipart/form-data" class="searchbox"> <form method="get" action="/ebooks/search/" accept-charset="utf-8" enctype="multipart/form-data" class="searchbox">
<input type="text" value="" id="menu-book-search" name="query" class="searchInput" title="" alt="Quick search" tabindex="20" size="20" maxlength="80" placeholder=" Quick search"/> <input type="text" value="" id="menu-book-search" name="query" class="searchInput" title="Quick search" alt="Quick search" tabindex="20" size="20" maxlength="80" placeholder=" Quick search"/>
<input type="submit" name="submit_search" value="Go!" style="vertical-align:middle;"> <input type="submit" name="submit_search" value="Go!" style="vertical-align:middle;">
</form> </form>
</div> </div>

773
gutenberg/pgrdf2marc.pl.txt Normal file
View File

@ -0,0 +1,773 @@
#!/usr/local/bin/perl -w
#
# pgrdf2marc.pl converts one or more items from the Project Gutenberg RDF
# catalog into MARC format record(s).
#
# Detailed POD-style documentation is at the end of this file.
use strict;
use Getopt::Long;
use Fcntl;
use GDBM_File;
#-----------------------------------------------------------------------
# Configurables:
# Organisation code
my $org = 'PGUSA';
my $publisher = 'Project Gutenberg';
my $marcdbpath = '/home/gbnewby/pgiso/marc/marc.db';
my $newpath = '/home/gbnewby/pgiso/marc';
my $chgpath = '/home/gbnewby/pgiso/marc';
#-----------------------------------------------------------------------
# NON-Configurables:
# ISO 639 Language Codes
# populate a hash mapping 639-1 (2-letter) codes to 639-2 (3-letter) codes
my %map639 = qw(
ab abk aa aar af afr sq alb am amh ar ara hy arm as asm
ay aym az aze ba bak eu baq bn ben bh bih bi bis be bre
bg bul my bur be bel ca cat zh chi co cos hr scr cs cze
da dan nl dut dz dzo en eng eo epo et est fo fao fj fij
fi fin fr fre fy fry gl glg ka geo de ger el gre kl kal
gn grn gu guj ha hau he heb hi hin hu hun is ice id ind
ia ina iu iku ik ipk ga gle it ita ja jpn jv jav kn kan
ks kas kk kaz km khm rw kin ky kir ko kor ku kur oc oci
lo lao la lat lv lav ln lin lt lit mk mac mg mlg ms may
ml mlt mi mao mr mar mo mol mn mon na nau ne nep no nor
or ori om orm pa pan fa per pl pol pt por ps pus qu que
rm roh ro rum rn run ru rus sm smo sg sag sa san sr scc
sh scr sn sna sd snd si sin ss ssw sk slo sl slv so som
st sot es spa su sun sw swa sv swe tl tgl tg tgk ta tam
tt tat te tel th tha bo tib ti tir to tog ts tso tn tsn
tr tur tk tuk tw twi ug uig uk ukr ur urd uz uzb vi vie
vo vol cy wel wo wol xh xho yi yid yo yor za zha zu zul
);
# input record separator is blank line
$/ = "\n\n";
# %cat is a temporary hash for the data extracted from RDF for each item.
my %cat;
my %options = ( debug => 0 );
GetOptions(\%options, 'debug!', 'help');
if ($options{'help'}) {
print qq!
pgrdf2marc.pl converts the Project Gutenberg RDF/XML format catalog into
MARC21 format records. RDF is read from STDIN, and MARC output to STDOUT.
Usage: pgrdf2marc.pl [ --help | --debug ]
--debug will dump the RDF and the MARC in text form
--help prints this message
!;
exit;
}
my %MARCDB;
# dbmopen %MARCDB, $marcdbpath, 0644 or die "Cannot open MARCDB file: $!\n";
tie %MARCDB, 'GDBM_File', $marcdbpath, O_CREAT|O_RDWR, 0644;
my $today = today();
open CHANGE, ">$chgpath/$today.mrc" or die "Cannot open CHANGE file: $!\n";
open NEW, ">$newpath/$today.mrc" or die "Cannot open NEW file: $!\n";
#-----------------------------------------------------------------------
my $rdfrecs = 0;
my $marcrecs = 0;
my $changes = 0;
my $newrecs = 0;
while (<>) {
next unless /rdf:ID="etext(\d+)"/;
$rdfrecs++;
if ($options{'debug'}) {
# dump the RDF
# print "$_\n";
}
tr/\r/ /; # remove CR (if any)
# convert commonly used character entities
s/ &amp; / and /sg;
s/&amp;/&/sg;
s/&#x2014;/--/sg;
if (&parse_rdf($_)) {
my @trec = &build_trec();
if ($options{'debug'}) {
# dump the MARC (pretty-printed)
foreach (@trec) { print "$_\n"; }
print "\n";
} else {
my $marc = &array2marc(@trec);
my $id = $cat{id};
# compare with existing record for change file
my $old = $MARCDB{$id}; $old = '' unless $old;
my $new = $marc;
# strip everything before 008 data ... (yes, horrible kludge!)
$old =~ s/.*?PGUSA.\d{14}\.0//;
$new =~ s/.*?PGUSA.\d{14}\.0//;
# if the record has changed, save it and write a copy to the CHANGE file
unless ( $new eq $old ) {
$MARCDB{$id} = $marc;
if ($old) {
print CHANGE $marc;
$changes++;
} else {
print NEW $marc;
$newrecs++;
}
}
}
$marcrecs++;
}
}
# now write out the MARC records to files, in bundles of 1000
my $outlimit = 0;
foreach my $id ( sort {$a <=> $b} keys %MARCDB ) {
if ( $id > $outlimit ) {
close OUT if $outlimit;
$outlimit += 1000;
my $outfile = sprintf "marc/%06d.mrc", $outlimit;
open OUT, ">$outfile" or die "Cannot open $outfile, $!\n";
}
print OUT $MARCDB{$id};
}
close OUT;
close CHANGE;
#dbmclose %MARCDB;
untie %MARCDB;
print STDERR qq|
$rdfrecs RDF records processed
$marcrecs MARC records written
$changes changed MARC records
$newrecs new MARC records
|;
exit(0);
#-----------------------------------------------------------------------
sub parse_rdf {
# parse an rdf entry and store the data in our catalogue hash
# clear %cat;
%cat = ();
$cat{title} = [];
$cat{created} = '||||-||-||';
# record must have an id ...
if (/rdf:ID="etext(\d+)"/) { $cat{id} = $1; } else { return 0; }
# ... and a title ...
unless (/<dc:title.*?>(.*?)<\/dc:title>/s) {
print STDERR "$cat{id} has no title!\n";
return 0;
}
while (s/<dc:title.*?>(.*?)<\/dc:title>//s) {
$cat{title} = [ @{ $cat{title} }, &split_field($1) ];
}
if (/<dc:created.*?<rdf:value>(.*)<\/rdf:value>/) {
$cat{created} = $1;
}
#if (/<dc:language.*?<rdf:value>(.*)<\/rdf:value>/) {
if (m!<dc:language><dcterms:ISO639-2><rdf:value>(.+)</rdf:value></dcterms:ISO639-2></dc:language>!) {
$cat{language} = $1;
}
if (/<dc:type.*?<rdf:value>(.*)<\/rdf:value>/) {
$cat{type} = $1;
}
if (/<dc:rights>(.*)<\/dc:rights>/) {
$cat{rights} = $1;
}
if (/<dc:creator.*?>(.*)<\/dc:creator>/s) {
$cat{author} = [ &split_field($1) ];
}
if (/<dc:contributor.*?>(.*)<\/dc:contributor>/s) {
$cat{contributor} = [ &split_field($1) ];
}
if (/<dcterms:LCC>(.*)<\/dcterms:LCC>/s) {
$cat{call} = [ &split_field($1) ];
}
if (/<dcterms:LCSH>(.*)<\/dcterms:LCSH>/s) {
$cat{subject} = [ &split_field($1) ];
}
if (/<dc:alternative.*?>(.*)<\/dc:alternative>/is) {
my $string = $1;
$string =~ s/\s+/ /gs;
$cat{alternative} = [ &split_field($string) ];
}
if (/<dc:description.*?>(.*)<\/dc:description>/is) {
my $string = $1;
$string =~ s/\s+/ /gs;
$cat{description} = [ &split_field($string) ];
}
if (/<dc:tableOfContents.*?>(.*)<\/dc:tableOfContents>/is) {
my $string = $1;
$string =~ s/\n/ -- /gs;
$string =~ s/\s+/ /gs;
$cat{contents} = [ &split_field($string) ];
}
# experimental kludge to determine genre
# genre is the 'Literary form' specified in the 008 character pos. 33
GENRE: {
if (/other (stories|tales)/i) { $cat{genre} = 'j'; last; }
if (/(poems|poetry)/i) { $cat{genre} = 'p'; last; }
if (/essays/i) { $cat{genre} = 'e'; last; }
if (/letters/i) { $cat{genre} = 'i'; last; }
if (/plays/i) { $cat{genre} = 'd'; last; }
if (/fiction/i) { $cat{genre} = '1'; last; }
$cat{genre} = '|';
}
return 1;
}
sub split_field {
# split a (possibly) multivalued field, returning values as an array.
my $field = shift;
# join multiple lines
$field =~ s/>\s+<//gs;
$field =~ s/&quot;/"/g;
my @array;
if ($field =~ /rdf:/i) {
while ($field =~ s/>([^<]+)<//s) {
push @array, $1;
}
} else {
push @array, $field;
}
return @array;
}
#-----------------------------------------------------------------------
sub build_trec {
# use %cat to build a text array of the MARC record
my @trec = ();
my ($ind2, $resp, $pubyear, $temp);
my ($name, $q, $d, $role);
my $id = $cat{id};
my $created = $cat{created};
my $language = $cat{language};
my $genre = $cat{genre};
my $type = $cat{type};
my $rights = $cat{rights};
my @titles = @{ $cat{title} };
my @alternative = @{ $cat{alternative} } if $cat{alternative};
my @authors = @{ $cat{author} } if $cat{author};
my @contribs = @{ $cat{contributor} } if $cat{contributor};
my @subjects = @{ $cat{subject} } if $cat{subject};
my @call = @{ $cat{call} } if $cat{call};
my @description = @{ $cat{description} } if $cat{description};
my @contents = @{ $cat{contents} } if $cat{contents};
# created is formatted as "yyyy-mm-dd" ...
$created = '||||-||-||' unless defined $created;
# extract a publication date (year only)
$pubyear = substr $created, 0, 4;
# reformat creation date as "yymmdd" for 008
$created =~ s/-//g;
$created = substr $created, 2, 6;
# (N.B. the 008 date is the create date for the MARC record.
# We're pretending that this is the same as the etext. Otherwise,
# this could just be today's date.)
$language = 'en' if (! defined $language);
my $lang639 = $map639{$language};
$lang639 = '|||' unless defined $lang639;
unless ($type) { $type = "Electronic text"; }
if ($type =~ /(.*), (.*)/) { $type = "$2 $1"; }
# start building the marc text array
push @trec, "LDR 00568cam a22001693a 4500";
push @trec, "001 $id";
push @trec, "003 $org";
# time stamp -- this is the date the record was created, not the PG item
push @trec, sprintf "005 %s", timestamp();
push @trec, sprintf "008 %6ss%4s||||xxu|||||s|||||000 %1s %3s d",
$created, $pubyear, $genre, $lang639;
push @trec, sprintf "040 |a%s|b%s", $org, $lang639;
push @trec, "042 |adc";
foreach (@call) {
push @trec, sprintf "050 4|a%s", $_;
}
if (@authors) {
my ($name, $d, $q, $c, undef) = &munge_author( shift @authors );
unless ($name =~ /(Various|Anonymous)/i) {
$temp = sprintf "100 1 |a%s", $name;
$temp .= "|c$c" if $c;
$temp .= "|q$q" if $q;
$temp .= ",|d$d" if $d;
push @trec, $temp;
}
}
# PG records can have 1 or 2 titles
# If there are 2, the first one is a Uniform title
my $ut = $#titles;
print STDERR "$id has $ut too many titles\n" if $ut > 1;
foreach my $title (@titles) {
# if the title contains line breaks, then the first marks the start of a subtitle, and
# any others are a mistake.
$title =~ s/\n/ : /s;
$title =~ s/\n/ /gs;
$ind2 = nonfilingIndicator( $title, $language );
if ( $ut ) { # Uniform title
$title =~
s{ (Catalan|Czech|Dutch|English|Esperanto|Finnish|French|German|Greek|Polish|Portuguese|Romany|Spanish)$}
{|l$1};
push @trec, sprintf "240 1%1d|a%s", $ind2, $title;
$ut = 0;
} else { # main title
$title =~ s/Other Stories/other stories/i;
for ($title) {
my ($a, $b) = split /:/, $title, 2;
if ( defined $b ) {
$b =~ s/^\s+//;
if ( $b =~ s/^(and|or),{0,1} /$1, / ) {
$title = "$a ;|b$b";
} elsif ($b) {
$title = "$a :|b$b";
}
}
}
$title =~ s/\s+/ /g;
$resp = &resp_stmt();
if ($resp) {
push @trec, sprintf
"245 1%1d|a%s|h[electronic resource] /|c%s", $ind2, $title, $resp;
} else {
push @trec, sprintf
"245 1%1d|a%s|h[electronic resource]", $ind2, $title;
}
}
}
push @trec, "260 |b$publisher,|c$pubyear";
#push @trec, "500 |aProject Gutenberg";
# Description
foreach (@description) {
push @trec, sprintf "500 |a%s", $_;
}
# Contents note
if (@contents) {
if ($#contents > 0) { # more than one element in contents!
push @trec, sprintf "505 0 |a%s", (join '--', @contents);
} else {
push @trec, sprintf "505 0 |a%s", $contents[0];
}
}
# Rights management / copyright statement
if ($rights) {
push @trec, "506 |a$rights";
} else {
push @trec, "506 |aFreely available.";
}
push @trec, "516 |a$type";
# Subject headings
# Note: we're using the 653 "uncontrolled terms" field, not LCSH
foreach (@subjects) {
push @trec, sprintf "653 |a%s", $_;
}
foreach (@authors) {
my ($name, $d, $q, $c, $role) = &munge_author( $_ );
$temp = "700 1 |a$name";
$temp .= "|c$c" if $c;
$temp .= "|q$q" if $q;
$temp .= ",|d$d" if $d;
$temp .= ",|e$role" if $role;
push @trec, $temp;
}
foreach (@contribs) {
my ($name, $d, $q, $c, $role) = &munge_author( $_ );
$temp = "700 1 |a$name";
$temp .= "|c$c" if $c;
$temp .= "|q$q" if $q;
$temp .= ",|d$d" if $d;
$temp .= ",|e$role" if $role;
push @trec, $temp;
}
foreach (@alternative) {
push @trec, sprintf "740 0 |a%s", $_;
}
push @trec, sprintf "830 0|aProject Gutenberg|v%d", $id;
push @trec, sprintf "856 40|uhttp://www.gutenberg.org/ebooks/%d", $id;
push @trec, "856 42|uhttp://www.gutenberg.org/license|3Rights"
unless $rights;
return @trec;
}
sub nonfilingIndicator {
# set non-filing indicator for title.
my ($title, $language) = @_;
my $ind2 = 0;
ARTICLE_CASE: {
if ($language eq 'en') { # English
$ind2 = 4 if $title =~ /^The /;
$ind2 = 3 if $title =~ /^An /;
$ind2 = 2 if $title =~ /^A /;
last;
}
if ($language eq 'fr') { # French
$ind2 = 4 if $title =~ /^(Les|Une) /;
$ind2 = 3 if $title =~ /^(Un|Le|La) /;
$ind2 = 2 if $title =~ /^L'/;
last;
}
if ($language eq 'de') { # German
$ind2 = 5 if $title =~ /^Eine /;
$ind2 = 4 if $title =~ /^(Ein|Der|Das|Die) /;
last;
}
if ($language eq 'du') { # Dutch
$ind2 = 4 if $title =~ /^(Een|Ene|Het) /;
$ind2 = 3 if $title =~ /^De /;
last;
}
if ($language eq 'es') { # Spanish
$ind2 = 4 if $title =~ /^(Las|Los) /;
$ind2 = 3 if $title =~ /^El /;
last;
}
if ($language eq 'it') { # Italian
$ind2 = 3 if $title =~ /^Il /;
last;
}
if ($language eq 'pt') { # Portuguese
$ind2 = 4 if $title =~ /^(Uma) /;
$ind2 = 3 if $title =~ /^(As|Os|Um) /;
$ind2 = 2 if $title =~ /^(A|O) /;
last;
}
}
return $ind2;
}
sub munge_author {
my $name = shift;
my ($d, $q, $c, $role);
# extract and discard role -- between []
if ($name =~ s/ \[([^\]]+)\]//) { $role = "\L$1\E"; }
# extract the dates (if any) and discard from name
# dates are assumed as anything starting with a digit
if ($name =~ s/, ([1-9-].+)//) { $d = $1; }
# extract and discard any expanded forenames -- these will be in ()
if ($name =~ s/ (\(.+\))//) { $q = $1; }
# extract and discard title
if ($name =~ s/ (Sir|Lord|Mrs|Rev|Saint|Dr|Jr)\b\.{0,1}//) { $c = $1; }
return ($name, $d, $q, $c, $role);
}
sub resp_stmt {
# generate a statement of responsibility from the author fields
my ($author, $name, $role, $resp);
my @authors = @{ $cat{author} } if $cat{author};
my @contribs = @{ $cat{contributor} } if $cat{contributor};
$resp = '';
# first author ...
$author = shift @authors;
if ($author) {
($name, undef) = munge_author( $author );
if ($name =~ /(.*?), (.*)/) { $name = "$2 $1"; }
$resp = "$name";
}
# followed by any additional authors ...
while ($author = shift @authors) {
($name, undef) = munge_author( $author );
if ($name =~ /(.*?), (.*)/) { $name = "$2 $1"; }
if (@authors) {
$resp .= ", $name";
} else {
$resp .= " and $name";
}
}
# followed by contributors ...
foreach $author (@contribs) {
($name, undef, undef, undef, $role) = munge_author( $author );
next unless $role;
if ($name =~ /(.*?), (.*)/) { $name = "$2 $1"; }
while (defined $role) {
if ($role =~ /edit/i) { $resp .= "; edited by $name"; last; }
if ($role =~ /Trans/i) { $resp .= "; translated by $name"; last; }
if ($role =~ /Illus/i) { $resp .= "; illustrated by $name"; last; }
#$resp .= "; $name";
#if ($role) { $resp .= " ($role)"; }
last; # only one pass thru required!
}
}
$resp =~ s/\s+/ /g;
return $resp;
}
#-----------------------------------------------------------------------
sub today {
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);
return sprintf "%4d-%02d-%02d.%02d%02d", $year+1900, $mon+1, $mday, $hour, $min;
}
sub timestamp {
my ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) = localtime(time);
return sprintf "%4d%02d%02d%02d%02d%02d.0", $year+1900, $mon+1, $mday, $hour, $min, $sec;
}
#-----------------------------------------------------------------------
sub array2marc {
my @trec = @_;
# initialise stuff
my $offset = 0;
my $dir = '';
my $data = '';
# default pattern for leader
my $ldrpat = "%05dnas 22%05duu 4500";
my ($line, $field, $tag, $fldlen, $base);
# if a leader is included, build the pattern from that ...
if ( $trec[0] =~ /^LDR/ ) { # leader codes
$line = shift(@trec);
# use the leader to create a pattern for building the leader later on
# only the RS, MC, BLC, EL, DCC and Linked are used
$ldrpat = '%05d'.substr($line,9,5).'22%05d'.substr($line,21,3).'4500';
}
# process all the tags in sequence
foreach $line ( @trec ) {
# build the directory and data portions
$tag = substr($line, 0, 3);
$field = substr($line, 4); # get the data for the tag
unless ($tag lt '010') {
$field =~ tr/\|/\037/s; # change subfield delimiter(s)
}
$field =~ s/$/\036/; # append a field terminator
$fldlen = length($field);
$dir .= sprintf("%3s%04d%05d",$tag,$fldlen,$offset);
$offset += $fldlen;
$data .= $field;
}
# append a field terminator to the directory
$dir =~ s/$/\036/;
# append the record terminator
$data =~ s/$/\035/;
# compute lengths
$base = length($dir) + 24; # base address of data
my $lrl = $base + length($data); # logical record length
# return the complete MARC record
return (sprintf $ldrpat,$lrl,$base) # leader
. $dir # directory
. $data; # data
}
__END__
=head1 NAME
pgrdf2marc.pl
=head1 DESCRIPTION
pgrdf2marc.pl converts one or more items from the Project Gutenberg RDF
catalog into MARC format record(s).
The RDF is read from STDIN, and the MARC output to STDOUT.
Dublin Core tags used in the RDF are:
dc:title
dc:alternative
dc:creator
dc:contributor
dc:tableOfContents
dc:publisher
dc:rights
dc:language
dc:created
dc:type
dcterms:LCSH
dcterms:LCC
A MARC record is simply an ASCII string of arbitrary length.
=head2 MARC record structure
Leader: start: 0 length: 24
Base Address (start of data): start: 12 length: 5
Directory: start: 24, length: (base - 24)
Tag number: 3 bytes
data length: 4 bytes
data offset: 5 bytes
Subfields begin with 0x1f
Fields end with 0x1e
Records end with 0x1d
=head2 Array element structure
The conversion process makes use of a simple array structure,
where each array element contains the tag and data for a single MARC
field, separated by a single space.
cols. 0-2 : tag number
col. 3 : blank
cols. 4-5 : indicators
cols. 6- : tag data
e.g.
245 10|aSome title|h[GMD]
The '|' character is used to represent MARC subfield separators (0x1f).
=head1 REFERENCES
MARC Standards, http://www.loc.gov/marc/
Dublin Core/MARC/GILS Crosswalk, http://www.loc.gov/marc/dccross.html
=head1 VERSION
Version 2011-01-15
=head1 AUTHOR
Steve Thomas <stephen.thomas@adelaide.edu.au>
=head1 LICENCE
Copyright (c) 2004-2011 Steve Thomas <stephen.thomas@adelaide.edu.au>
Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
=cut
__END__
<pgterms:etext rdf:ID="etext12765">
<dc:publisher>&pg;</dc:publisher>
<dc:title rdf:parseType="Literal">Geordie's Tryst
A Tale of Scottish Life</dc:title>
<dc:creator rdf:parseType="Literal">Rae, Mrs. Milne</dc:creator>
<pgterms:friendlytitle rdf:parseType="Literal">Geordie's Tryst by Mrs. Milne Rae</pgterms:friendlytitle>
<dc:language><dcterms:ISO639-2><rdf:value>en</rdf:value></dcterms:ISO639-2></dc:language>
<dc:created><dcterms:W3CDTF><rdf:value>2004-06-28</rdf:value></dcterms:W3CDTF></dc:created>
<dc:rights rdf:resource="&lic;" />
</pgterms:etext>
#!/usr/bin/perl -w
use Fcntl;
use GDBM_File;
use NDBM_File;
tie %newhash, 'GDBM_File', 'newdb', O_CREAT|O_RDWR, 0644;
tie %oldhash, 'NDBM_File', "marcdb", 1, 0;
%newhash = %oldhash;
untie %newhash;
untie %oldhash;

View File

@ -14,7 +14,7 @@ Please note:
- You cannot click on the address, but must copy it to your email program manually and adjust it to be a valid email address. We apologize for the inconvenience but this helps hiding our addresses from spammers. - You cannot click on the address, but must copy it to your email program manually and adjust it to be a valid email address. We apologize for the inconvenience but this helps hiding our addresses from spammers.
- Include a descriptive subject line, or your email will end up in our spam jail. - Include a descriptive subject line, or your email will end up in our spam jail.
- Don't send HTML email. - Don't send email as HTML only, or only within attachments.
- Be patient. We get a lot of email. If you don't get a response within the time mentioned below, please resend your email. - Be patient. We get a lot of email. If you don't get a response within the time mentioned below, please resend your email.
Please select the most appropriate address from this list. Please select the most appropriate address from this list.
@ -27,7 +27,7 @@ Please select the most appropriate address from this list.
Errata within eBooks. To report an error within an eBook (such as a missing word), please be sure to include the eBook number or specific filename or download link you used. Error reports are easiest to handle when they clearly indicate the context in which an error was found. Note that since Project Gutenberg includes many old titles, it is common for unusual spelling or arcane word uses to be used. If possible, check a printed source to verify whether an error exists, before reporting it. Messages to the errata list generate an automatic response that your report was received. Errata within eBooks. To report an error within an eBook (such as a missing word), please be sure to include the eBook number or specific filename or download link you used. Error reports are easiest to handle when they clearly indicate the context in which an error was found. Note that since Project Gutenberg includes many old titles, it is common for unusual spelling or arcane word uses to be used. If possible, check a printed source to verify whether an error exists, before reporting it. Messages to the errata list generate an automatic response that your report was received.
Any errata/bug/typo report is welcome! There is additional guidance in the FAQ on how to prepare errata reports so they are easiest for the Project Gutenberg team to handle. Start with [FAQ #R.26]() on how to report typos. Any errata/bug/typo report is welcome! There is additional guidance in the FAQ on how to prepare errata reports so they are easiest for the Project Gutenberg team to handle. Start with [this guidance](/help/errata.html) on how to report typos.
3. catalog2020 (at) pglaf.org 3. catalog2020 (at) pglaf.org
@ -44,9 +44,9 @@ Please select the most appropriate address from this list.
## Postal Mail ## Postal Mail
If you need to send printed mail, please consider instead scanning and emailing to the appropriate address above. But if you really need to send something physical, send to this address: If you need to send printed mail, please consider instead scanning and emailing to the appropriate address above. But if you really need to send something physical, send to this address:
Project Gutenberg Literary Archive Foundation <dl><dd> Project Gutenberg Literary Archive Foundation</dd>
809 North 1500 West <dd> 809 North 1500 West</dd>
Salt Lake City, UT 84116 <dd> Salt Lake City, UT 84116</dd></dl>
## Newsletter and Discussion Lists ## Newsletter and Discussion Lists
For subscribing our mailing lists, visit our [Subscribe How-To] page. There is a monthly email newsletter, also some discussion lists (gutvol-d is the most active, for discussions among volunteers). For subscribing our mailing lists, visit our [Subscribe How-To] page. There is a monthly email newsletter, also some discussion lists (gutvol-d is the most active, for discussions among volunteers).

View File

@ -12,18 +12,16 @@ Project Gutenberg is an online library of free eBooks.
Project Gutenberg was the first provider of free electronic books, or Project Gutenberg was the first provider of free electronic books, or
eBooks. Michael Hart, founder of Project Gutenberg, invented eBooks eBooks. Michael Hart, founder of Project Gutenberg, invented eBooks
in 1971 and his memory continues to inspire the creation of eBooks and in 1971 and his memory continues to inspire the creation of eBooks and
related technologies today. related content today.
Project Gutenberg Mission Statement ## Project Gutenberg Mission Statement
-----------------------------------
To encourage the creation and distribution of eBooks. *To encourage the creation and distribution of eBooks.*
[A 2004 essay](/about/background/mission_statement.html) by Michael Hart provides more detail on the mission statement, and some of the beliefs that guide Project Gutenberg's activities in fulfillment of that mission. [A 2004 essay](/about/background/mission_statement.html) by Michael Hart provides more detail on the mission statement, and some of the beliefs that guide Project Gutenberg's activities in fulfillment of that mission.
More about Project Gutenberg ## More about Project Gutenberg
---------------------------- To read more about Project Gutenberg, choose one of these topics:
To read more about Project Gutenberg, choose one of these topics:
[Background, History and Philosophy](/about/background/index.html): Various essays and articles. [Background, History and Philosophy](/about/background/index.html): Various essays and articles.

28
site/ebooks/feeds.md Normal file
View File

@ -0,0 +1,28 @@
---
layout: default
title: Feeds of new eBooks | Project Gutenberg
permalink: /ebooks/feeds.html
---
Feeds of New eBooks
===================
Also see the [offline catalogs](/ebooks/offline_catalogs.html) page.
## New Publications Feeds
You can keep updated on new publications in a few different ways.
### Social media
*Twitter:* Follow [@gutenberg_new](https://twitter.com/gutenberg_new). *Freshness:* within an hour after a new eBook is posted, or whenever an eBook is updated.
*Facebook:* "Like" [gutenberg.new](https://www.facebook.com/gutenberg.new) to have us post new books to your Facebook feed. *Freshness:* within an hour after a new eBook is posted, or whenever an eBook is updated.
## RSS
Use your favorite RSS reader to load [http://www.gutenberg.org/cache/epub/feeds/today.rss](http://www.gutenberg.org/cache/epub/feeds/today.rss). This includes eBooks posted or updated in the last 24 hours. *Freshness:* Updated nightly.
## Email
Subscribe to the "posted" email list at [lists.pglaf.org](https://lists.pglaf.org). *Freshness:* when a new eBook is uploaded to the servers for processing. It can take up to two hours for a new eBook to be available in the catalog.

View File

@ -0,0 +1,79 @@
---
layout: default
title: Offline Catalogs | Project Gutenberg
permalink: /ebooks/offline_catalogs.html
---
Offline Catalogs
================
This page tells you how to find and get Project Gutenberg eBooks if:
- you don't want to use a browser to download eBooks but prefer other software like an ftp-client or wget, or
- you are on a slow or limited internet connection, or
- you'd rather have a handy book catalog to consult offline, or
- you would like to make your own listings or derivatives from this information.
## List of Sites Hosting Project Gutenberg EBooks
The Project Gutenberg collection is available from dozens of sites offering access via http/https, ftp, rsync, and a few other methods. See our listing of [mirror sites](/dirs/MIRRORS.ALL) to choose the location, access method, or speed. Mirrors generally do not have a friendly Web-based front end, but do have the collection. See the [mirroring how-to](/help/mirroring.html) for details.
## The GUTINDEX Listings of EBooks
Updated at least monthly. These plain text files provide the basic information about each eBook, and are good for searching from your own system (for example, use control-F in a Web browser or word processor). Note that these files are not recommended for automation (that is, to use as input to generate a computerized database). Instead, use one of the catalog files mentioned below.
* [GUTINDEX.ALL](/dirs/GUTINDEX.ALL)
* [GUTINDEX.zip](/dirs/GUTINDEX.zip) (same as above zipped)
### GUTINDEX Listings by Year
If GUTINDEX.ALL is too big for you or you prefer separate annual lists, you can download GUTINDEX files by year.
* [GUTINDEX.2019](/dirs/GUTINDEX.2019)
* [GUTINDEX.2018](/dirs/GUTINDEX.2018)
* [GUTINDEX.2017](/dirs/GUTINDEX.2017)
* [GUTINDEX.2016](/dirs/GUTINDEX.2016)
* [GUTINDEX.2015](/dirs/GUTINDEX.2015)
* [GUTINDEX.2014](/dirs/GUTINDEX.2014)
* [GUTINDEX.2013](/dirs/GUTINDEX.2013)
* [GUTINDEX.2012](/dirs/GUTINDEX.2012)
* [GUTINDEX.2011](/dirs/GUTINDEX.2011)
* [GUTINDEX.2010](/dirs/GUTINDEX.2010)
* [GUTINDEX.2009](/dirs/GUTINDEX.2009)
* [GUTINDEX.2008](/dirs/GUTINDEX.2008)
* [GUTINDEX.2007](/dirs/GUTINDEX.2007)
* [GUTINDEX.2006](/dirs/GUTINDEX.2006)
* [GUTINDEX.2005](/dirs/GUTINDEX.2005)
* [GUTINDEX.2004](/dirs/GUTINDEX.2004)
* [GUTINDEX.2003](/dirs/GUTINDEX.2003)
* [GUTINDEX.2002](/dirs/GUTINDEX.2002)
* [GUTINDEX.2001](/dirs/GUTINDEX.2001)
* [GUTINDEX.2000](/dirs/GUTINDEX.2000)
* [GUTINDEX.1999](/dirs/GUTINDEX.1999)
* [GUTINDEX.1998](/dirs/GUTINDEX.1998)
* [GUTINDEX.1997](/dirs/GUTINDEX.1997)
* [GUTINDEX.1996](/dirs/GUTINDEX.1996) (and earlier)
## Directory/Folder Listings
You can navigate the directory/folder contents starting at [/dirs](/dirs), however this is not very user-friendly.
## The Project Gutenberg Catalog Metadata in Machine-Readable Format
### XML/RDF
All Project Gutenberg metadata are [available digitally](/dirs/cache/feeds/) in the XML/RDF format. This is updated daily (other than the legacy format mentioned below). Please use one of these files as input to a database or other tools you may be developing, instead of [crawling or roboting](/policy/robot_access.html) the website.
Note that the exact same metadata is available as a *per-eBook* .rdf file. These are found in the cache/epub (i.e., cache/generated) directory, accessible by mirroring or by the directory/folder listings above. The large XML/RDF file is simply a concatenation of all the per-eBook metadata.
### MARC Records (MAchine Readable Cataloging)
MARC is a common metadata format utilized by library card catalog databases. Steve Thomas of the University of Adelaide provided a Perl script to generate MARC records from the XML/RDF catalog files. Find it here: [pgrdf2marc.pl](/gutenberg/pgrdf2marc.pl.txt). You will need to rename it, and make any necessary changes to run on your own system. This is unsupported software, provided without warranty or guarantee.
These instructions were provided to Project Gutenberg, and are listed here in the hopes they may be useful.
- Download the XML/RDF file (i.e., [https://www.gutenberg.org/cache/epub/feeds/rdf-files.tar.zip](https://www.gutenberg.org/cache/epub/feeds/rdf-files.tar.zip).
- Unzip, untar
- Run your modified copy of the Adelaide script above, pgrdf2marc.pl, against the untarred/unzipped RDF files to generate MARC records (there may be a few RDF records that do not convert, perhaps as many as 100)
## A Local, Browsable Copy on your own Computer or Mobile Device
[Kiwix](https://wiki.kiwix.org/wiki/Content) is an application that lets you download a large collection and use it locally. A copy of the Project Gutenberg content was made available in November 2018, and may be updated periodically.

View File

@ -0,0 +1,30 @@
---
layout: default
title: 403 | Project Gutenberg
permalink: /gutenberg/error403.html
---
Error 403
=========
Sorry, but our website automatically denied you access to that page.
Maybe you have just a wrong url. Go to [www.gutenberg.org](/) to see whether the error persists.
If you get the error again, this might explain what is happening:
- Visiting from a German Internet address? As of February 27 2018, addresses in Germany are blocked. For more information, see <a href="https://block.pglaf.org/germany.shtml">block.pglaf.org/germany.shtml</a>.</li>
- Anonymized IP addresses might trigger automated anti-abuse blocks. This can happen with anonymizers, open proxies, VPNs, or TOR, and includes the Google proxies that are used by Chrome.</li>
- Don't access Project Gutenberg from hosted servers.</li>
- Don't use automated software to download lots of books. We have a limit on how fast you can go while using this site. If you surpass this limit you get blocked automatically, and eventually blocks expire automatically.</li>
- Kindle users, and people using shared IP addresses (such as some schools) might trigger a block due to too many requests coming from the same address. </li>
- If you use the RSS feed, set your update interval to 24 hours.</li>
## What to do if I'm blocked inappropriately
If you are sure that none of the above applies to you,
and wish us to investigate the problem, please visit
<a href="http://block.pglaf.org">block.pglaf.org</a> and send the diagnostic
information to the email address listed there.
If you were blocked mistakenly or inappropriately from accessing Project Gutenberg, we apologize for this. There are a variety of mechanisms we use to try to keep the site responsive, and they do not always work as intended. The instructions above will help to adjust the system, to enhance the ability of people to read Project Guteberg eBooks.

View File

@ -0,0 +1,14 @@
---
layout: default
title: 404 | Project Gutenberg
permalink: /gutenberg/error404.html
---
Error 404
=========
Sorry, but our website does not have the page you requested.
Maybe you have just a wrong url. Go to [www.gutenberg.org](/) to see whether the error persists.
If you think something is broken, follow the "Contact Information" link at the bottom of this page if you would like to report it.

View File

@ -0,0 +1,10 @@
---
layout: default
title: 503 | Project Gutenberg
permalink: /gutenberg/error503.html
---
Error 503
=========
Sorry, but our service is temporarily unavailable. This is a temporary situation. Please check back later.

View File

@ -1,7 +1,7 @@
--- ---
layout: default layout: default
title: Frequently Asked Questions | Project Gutenberg title: Frequently Asked Questions | Project Gutenberg
permalink: /how_to/faq.html permalink: /help/faq.html
--- ---
Frequently Asked Questions about Project Gutenberg Frequently Asked Questions about Project Gutenberg
@ -14,7 +14,8 @@ Contents
<ol class="inner_1"> <ol class="inner_1">
<li><a href="#what-is-project-gutenberg">What is Project Gutenberg?</a></li> <li><a href="#what-is-project-gutenberg">What is Project Gutenberg?</a></li>
<li><a href="#where-did-project-gutenberg-come-from">Where did Project Gutenberg come from?</a></li> <li><a href="#where-did-project-gutenberg-come-from">Where did Project Gutenberg come from?</a></li>
<li><a href="#what-has-project-gutenberg-achieved">What has Project Gutenberg achieved?</a></li> <li><a href="#tell-me-about-project-gutenbergs-longevity">http://www.michaelgeist.ca/2019/12/making-the-best-of-a-bad-provision-why-canada
-should-work-toward-a-copyright-term-extension-registration-requirement/</a></li>
<li><a href="#who-runs-project-gutenberg">Who runs Project Gutenberg?</a></li> <li><a href="#who-runs-project-gutenberg">Who runs Project Gutenberg?</a></li>
<li><a href="#how-many-people-are-in-project-gutenberg">How many people are in Project Gutenberg?</a></li> <li><a href="#how-many-people-are-in-project-gutenberg">How many people are in Project Gutenberg?</a></li>
<li><a href="#how-can-i-contact-project-gutenberg">How can I contact Project Gutenberg?</a></li> <li><a href="#how-can-i-contact-project-gutenberg">How can I contact Project Gutenberg?</a></li>
@ -58,7 +59,7 @@ Starting in 1991, Project Gutenberg began to take its current form, with many di
There is more history and background in the [Background, History and Philosophy](/background/) section. There is more history and background in the [Background, History and Philosophy](/background/) section.
### Tell me about Project Gutenberg's longevity? ### Tell me about Project Gutenberg's longevity
Project Gutenberg is the original, and oldest, eBook project on the Internet, founded in 1971. It is one of the oldest online content providers in the world that is still operating. Project Gutenberg is the original, and oldest, eBook project on the Internet, founded in 1971. It is one of the oldest online content providers in the world that is still operating.

View File

@ -11,6 +11,8 @@ Here are pages that give background about Project Gutenberg, including how new i
<div class="bookshelves "> <div class="bookshelves ">
<ul> <ul>
<h2>A</h2>
<li><a href="/about">About Project Gutenberg</a> (main page)</li>
<h2>C</h2> <h2>C</h2>
<li><a href="/help/copyright.html">Copyright How-To</a></li> <li><a href="/help/copyright.html">Copyright How-To</a></li>
<h2>E</h2> <h2>E</h2>
@ -22,8 +24,11 @@ Here are pages that give background about Project Gutenberg, including how new i
<li><a href="/help/mirroring.html">Mirroring How-To</a></li> <li><a href="/help/mirroring.html">Mirroring How-To</a></li>
<h2>N</h2> <h2>N</h2>
<li><a href="/help/no_sweat_copyright.html">No Sweat of the Brow copyright</a></li> <li><a href="/help/no_sweat_copyright.html">No Sweat of the Brow copyright</a></li>
<h2>O</h2>
<li><a href="/ebooks/offline_catalogs.html">Offline catalogs</a>, including metadata and eBook listings.</li>
<h2>P</h2> <h2>P</h2>
<li><a href="/policy/permission.html">Permission How-To</a></li> <li><a href="/policy/permission.html">Permission and licensing</a></li>
<li><a href="/policy/">Policies</a> (main page)</li>
<li><a href="/help/public_domain_ebook_submission.html">Public Domain eBook Submission How-To</a></li> <li><a href="/help/public_domain_ebook_submission.html">Public Domain eBook Submission How-To</a></li>
<h2>S</h2> <h2>S</h2>
<li><a href="/help/submitting_your_own_work.html">Submitting Your Own Work How-To</a></li> <li><a href="/help/submitting_your_own_work.html">Submitting Your Own Work How-To</a></li>

View File

@ -79,13 +79,13 @@ There is an historical anomaly with the generated content. In the main collectio
</pre> </pre>
## Getting Your Mirror Listed ## Getting Your Mirror Listed
Once you have successfully installed and tested your configuration, we'll add your site to the list of mirrors, so people can find you. Email [help2019_AT_pglaf.org](mailto:help2019_AT_pglaf.org) and we'll announce it in our next newsletters. After a month or so (to confirm stability) we'll add you to the mirror list and to the mirror selection page of each eBook. Once you have successfully installed and tested your configuration, we'll add your site to the list of mirrors, so people can find you. Email *help2020 @ pglaf.org* and we'll announce it in our next newsletters. After a month or so (to confirm stability) we'll add you to the mirror list and to the mirror selection page of each eBook.
Before you start you might want to view our [mirror list](//www.gutenberg.org/MIRRORS.ALL) to check whether the geographical location of your server would be a good addition to the list. Before you start you might want to view our [mirror list](//www.gutenberg.org/MIRRORS.ALL) to check whether the geographical location of your server would be a good addition to the list.
The book directories are the only part we offer for mirror. The Project Gutenberg catalog in XML/RDF is in the root directory of the generated content, if you would like to make your own search software. We do not distribute the central search software or Web pages used at www.gutenberg.org, however. Also, note that we only currently link to mirrors for the main collection, not the generated content. The book directories are the only part we offer for mirror. The Project Gutenberg catalog in XML/RDF is in the root directory of the generated content, if you would like to make your own search software. We do not distribute the central search software or Web pages used at www.gutenberg.org, however. Also, note that we only currently link to mirrors for the main collection, not the generated content.
You may distribute our books by any means you choose: HTTP, FTP, rsync, BitTorrent, p2p or others. You may distribute our books by any means you choose: HTTP, FTP, rsync, TOR, BitTorrent, p2p or others.
Thanks for your interest in helping Project Gutenberg reach more readers. Thanks for your interest in helping Project Gutenberg reach more readers.

View File

@ -16,70 +16,58 @@ Tablets, Phones and eReaders How-To
<ol class="inner_1"> <ol class="inner_1">
<li><a href="#general-kindle-help">General Kindle help</a></li> <li><a href="#general-kindle-help">General Kindle help</a></li>
<li><a href="#blocked-users">Blocked Users</a></li> <li><a href="#blocked-users">Blocked Users</a></li>
<li><a href="#kindle-fire-review-from-2012">Kindle Fire Review from 2012</a>
<ol class="inner_2"> <ol class="inner_2">
<li><a href="#alternate-apps-and-formats">Alternate Apps and Formats</a></li> <li><a href="#alternate-apps-and-formats">Alternate Apps and Formats</a></li>
</ol> </ol>
</li> </li>
<li><a href="#kindle-3">Kindle 3</a></li> <li><a href="#kindle-3">Kindle 3</a></li>
<li><a href="#amazons-new-file-format">Amazon's new File Format</a></li> <li><a href="#amazons-newer-file-format">Amazon's new File Format</a></li>
</ol> </ol>
</li> </li>
<li><a href="#nook">Nook</a></li> <li><a href="#nook">Nook</a></li>
<li><a href="#kobo-reader">Kobo Reader</a></li> <li><a href="#kobo-reader">Kobo Reader</a></li>
<li><a href="#android">Android</a> <li><a href="#android">Android</a>
<ol class="inner_1">
<li><a href="#free-fb-reader">Free: FBReader</a></li>
</ol>
</li>
<li><a href="#ipad-iphone-and-ipod-touch">iPad, iPhone and iPod Touch</a>
<ol class="inner_1">
<li><a href="#free-lexcycle-stanza">Free: Lexcycle Stanza</a></li>
<li><a href="#free-himalaya">Free: Himalaya</a></li>
<li><a href="#paid-eucalyptus">Paid: Eucalyptus</a></li>
<li><a href="#paid-megareader">Paid: MegaReader</a></li>
<li><a href="#paid-quickreader">Paid: QuickReader</a></li>
</ol>
</li> </li>
<li><a href="#ipad-iphone-and-ipod-touch">iPad, iPhone and iPod Touch</a></li>
<li><a href="#suggestions-from-project-gutenberg-founder-michael-hart">9 Suggestions from Project Gutenberg Founder Michael Hart</a></li> <li><a href="#suggestions-from-project-gutenberg-founder-michael-hart">9 Suggestions from Project Gutenberg Founder Michael Hart</a></li>
</ol> </ol>
</div> </div>
## Project Gutenberg is not just for your desktop or notebook computer! ## Project Gutenberg is not just for your desktop or notebook computer!
The Nook, Kindle, Sony EReader, iPad and other eBook readers can display Project All modern tablets, smartphones, and eBook readers we know about can
Gutenberg eBooks (we are not going to try to list them all here, but every such display Project Gutenberg eBooks (we are not going to try to list them
device we are aware of has the ability to display one or more of Project all here, but every such device we are aware of has the ability to
Gutenberg\'s typical file formats). Most recent mobile phones can also display them. Many MP3 display one or more of Project Gutenberg's typical file formats).
players, gaming systems, and other devices can display eBooks, too. The Many MP3 players, gaming systems, and other devices can display
Project Gutenberg site offers download formats suitable for eBook eBooks, too. The Project Gutenberg site offers download formats
readers, mobile phones, and other devices. suitable for eBook readers, mobile phones, and other devices.
There are several different ways of obtaining and viewing the titles, There are several different ways of obtaining and viewing the titles,
and most people will be able to choose whichever suits them best. and most people will be able to choose whichever suits them best.
Before getting started, check with your device's documentation to Before getting started, check with your device's documentation to
determine which formats you can display. This page lists the formats determine which formats you can display.
that Project Gutenberg offers: [This page](/help/file_formats.html) lists the formats that Project
[Help on Bibliographic Record Page](/) Gutenberg offers.
Here are some of the ways we know of to get Project Gutenberg eBooks Here are some of the ways we know of to get Project Gutenberg eBooks
to your eBook reader or mobile phone: to your eBook reader or mobile phone:
1. Try the [Project Gutenberg Mobile Site](/). This site is optimized for smaller screens. 1. Read the eBook online. All the devices we know about have the ability to display Web pages, and that is one of the formats available for nearly every Project Gutenberg eBook.
2. Download eBooks directly to your device over the Internet. If your device is Internet-enabled, just visit the catalog page for a book, and download one of the formats your device can display. Here is a sample catalog page: [www.gutenberg.org/ebooks/11](//www.gutenberg.org/ebooks/11). Use the author/title search boxes on every page at www.gutenberg.org to find eBooks you are interested in. 2. Download eBooks directly to your device over the Internet. If your device is Internet-enabled, just visit the catalog landing page for a book, and download one of the formats your device can display. Here is a sample catalog landing page: [www.gutenberg.org/ebooks/11](/ebooks/11). Use the author/title search boxes on every page at www.gutenberg.org to find eBooks you are interested in.
3. Use a third party site (including some for-fee sites), which facilitate getting files onto your device. Try [Project Gutenberg's partners and affiliates](/wiki/Gutenberg:Partners,_Affiliates_and_Resources) Here is the magic catalog for Project Gutenberg titles, created in MOBI and EPUB versions (MOBI is suitable for the Kindle): [http://www.freekindlebooks.org/MagicCatalog/magic/ebooks/index.html](http://www.freekindlebooks.org/MagicCatalog/magic/ebooks/index.html) 3. Download to your computer, and transfer (i.e., "side load") to your device. This might be done with a USB cable, Bluetooth, or another method.
4. Other methods, as supported by your device. For example, the Kindle supports an email method to transform and receive files. 4. Use a third party site (including some for-fee sites), which facilitate getting files onto your device.
5. Other methods, as supported by your device. For example, the Kindle supports an email method to transform and receive files.
## Search For Guidance ## Search For Guidance
Many articles have been written on different approaches to getting Project Gutenberg content onto different devices. Use your favorite search site to look for guidance. These include articles on specific devices, as well on how convert Gutenberg files to other formats.[This article](http://www.makeuseof.com/tag/3-good-online-sources-free-ebooks-free-app-read/) at makeuseof.com describes conversion for Project Gutenberg content. Many articles have been written on different approaches to getting Project Gutenberg content onto different devices. Use your favorite search site to look for guidance. These include articles on specific devices, as well on how convert Gutenberg files to other formats.[This article](http://www.makeuseof.com/tag/3-good-online-sources-free-ebooks-free-app-read/) at makeuseof.com describes conversion for Project Gutenberg content.
## General Advice ## General Advice
There are a few different challenges that many people face. Here are some of the ones we hear about most often. Keep in mind that there are many different types of computers, and they can be set up differently and have different software. So, your specific experience might be a little different than someone else's. This also means that step-by-step instructions might need some variation for your own situation. There are a few different challenges that many people face. Here are some of the ones we hear about most often. Keep in mind that there are many different types of computers, and they can be set up differently and have different software. So, your specific experience might be a little different than someone else's. This also means that step-by-step instructions might need some variation for your own situation.
1. How to save an eBook's file to transfer to your device. If you are using your computer to look at an eBook, you can save the eBook's file(s) to your computer so that you can copy it to your device. Try the "save as..." ... "HTML Complete" option in your Web browser to save the file(s) to a folder you choose, so that you can later transfer the files to your device. If you want to get a particular file format (such as the EPUB or MOBI format), from the Project Gutenberg download page you can right-click to get a pop-up menu, then "save as..." (or a similar option). If you don't have a right mouse button (on some Macs), use control-click to get the pop-up menu. 1. How to save an eBook's file to transfer to your device. If you are using your computer to look at an eBook, you can save the eBook's file(s) to your computer so that you can copy it to your device. Try the "save as..." ... "HTML Complete" option in your Web browser to save the file(s) to a folder you choose, so that you can later transfer the files to your device. If you want to get a particular file format (such as the EPUB or MOBI format), from the Project Gutenberg download page you can right-click to get a pop-up menu, then "save as..." (or a similar option). If you don't have a right mouse button (on some Macs), use control-click to get the pop-up menu.
For HTML, make sure you save the complete page. Some Web browsers just download the HTML (the text), and link back to the images at the www.gutenberg.org site. This won't work, since viewing the book will require you to be online, and link "inline" to those images. Project Gutenberg wants you to have the WHOLE eBook - download the complete HTML with images. All Web browsers offer this as a menu option, but it might not be the default choice. For HTML, make sure you save the complete page. Some Web browsers just download the HTML (the text), and link back to the images at the www.gutenberg.org site. This won't work, since viewing the book will require you to be online, and link "inline" to those images. Project Gutenberg wants you to have the WHOLE eBook - download the complete HTML with images. All Web browsers offer this as a menu option, but it might not be the default choice.
1. Where is the file? If you just left-click a file to download, you might get a dialog box or something similar, asking whether you want to save the file. But where did it go? It seems there are many different places your computer might save the file, and they can be hard to find later. Use the "save as..." method mentioned above to choose a specific location. Also, keep in mind that the Project Gutenberg files might have names that don't related to the book's title (we use a numeric file naming scheme based on the eBook number). You can rename the files to anything you'd like, but you will first need to know where they are saved. 1. Where is the file? If you simply click a file to download, you might get a dialog box or something similar, asking whether you want to save the file. But where did it go? It seems there are many different places your computer might save the file, and they can be hard to find later. Use the "save as..." method mentioned above to choose a specific location. Also, keep in mind that the Project Gutenberg files might have names that don't related to the book's title (we use a numeric file naming scheme based on the eBook number). You can rename the files to anything you'd like, but you will first need to know where they are saved.
2. How to get the file to my device? This varies quite a bit, but the first step is to find where you saved the file (sometimes you can save directly to your device, if it is connected). One common variation is to connect your device to your computer, often with a USB cable. Then, just drag and drop (or use another method for copying files) to put the file on your device. Another common variation is to use a separate program that manages your device's content, and to open the file and transfer it from within that program (iTunes is a common example of this). 2. How to get the file to my device? This varies quite a bit, but the first step is to find where you saved the file (sometimes you can save directly to your device, if it is connected). One common variation is to connect your device to your computer, often with a USB cable. Then, just drag and drop (or use another method for copying files) to put the file on your device. Another common variation is to use a separate program that manages your device's content, and to open the file and transfer it from within that program (iTunes is a common example of this).
3. Hey, it doesn't look right! Project Gutenberg relies on several automated steps to create EPUB, MOBI, and some other specialized eBook reader formats. For a variety of reasons, this automation sometimes yields files that don't look right on every device, particularly those with small screens. One common problem is to have lots of white space at the top of an eBook, or very wide margins. Also, it might be that images (from the HTML version of the book) are not included in the automatically-generated version. If you got the right file, but it doesn't look right, it's probably not something you can fix. Try another file format, especially HTML or plain text. HTML and plain text can be viewed by many of the specialized eBook reader devices and mobile phones. 3. Hey, it doesn't look right! Project Gutenberg relies on several automated steps to create EPUB, MOBI, and some other specialized eBook reader formats. For a variety of reasons, this automation sometimes yields files that don't look right on every device, particularly those with small screens. One common problem is to have lots of white space at the top of an eBook, or very wide margins. Also, it might be that images (from the HTML version of the book) are not included in the automatically-generated version. If you got the right file, but it doesn't look right, it's probably not something you can fix. Try another file format, especially HTML or plain text. HTML and plain text can be viewed by many of the specialized eBook reader devices and mobile phones.
@ -94,11 +82,8 @@ Since 2014, Amazon Kindle users have reported being detected as "robots" by the
The exact conditions under which this aggregation takes place are not clear. We do not have a workaround to disable this outcome. If your device is blocked, the block will expire automatically though it may appear again depending on Amazon's routing of queries to www.gutenberg.org. A good workaround is to instead use your computer to access www.gutenberg.org, and transfer items to your Kindle as described herein. The exact conditions under which this aggregation takes place are not clear. We do not have a workaround to disable this outcome. If your device is blocked, the block will expire automatically though it may appear again depending on Amazon's routing of queries to www.gutenberg.org. A good workaround is to instead use your computer to access www.gutenberg.org, and transfer items to your Kindle as described herein.
### Kindle Fire Review from 2012
In 2012, the Project Gutenberg Webmaster wrote a [Kindle Fire review.](/wiki/Gutenberg:Kindle_Fire_Review) Summary: If you fancy free eBooks, don't buy a Kindle Fire. The review suggests readers consider a Nexus 7 instead. Note that the products from Amazon and other suppliers have evolved, since this review was written.
### Alternate Apps and Formats ### Alternate Apps and Formats
For the Kindle Fire, and potentially other Kindle devices, you can install alternate eBook reader software. Advice we have received (might need adjustment for your specific device, or if some versions of software are updated from when these instructions were written): **install a third party EPUB reader** and start downloading the EPUB files instead of the Kindle files from this site. One good and free EPUB reader is [FBReader](http://www.fbreader.org/FBReaderJ). Download the *Android .2\* * package for the Kindle Fire and the *Android 4.\* * package for the Kindle Fire HD. You may want to read up on installing third party apps on the Kindle Fire. Advantages of EPUB files over Kindle files include: that they are much smaller than Kindle files and that they work on the Apple iPad too. Many or all Kindles allow you to install alternate eBook reader software. Advice we have received (which might need adjustment for your specific device, or if some versions of software are updated from when these instructions were written): **install a third party EPUB reader** and start downloading the EPUB files instead of the Kindle files from this site. You may want to read up on installing third party apps on the Kindle Fire. Advantages of EPUB files over Kindle files include: that they are much smaller than Kindle files and that they work on the Apple iPad too.
### Kindle 3 ### Kindle 3
The Amazon "Kindle 3" device seem to work well with Project Gutenberg titles; the Kindle DX also. Amazon used to have instructions available for downloading Project Gutenberg titles, but this seems to be gone now. They do have some free content, and an app, in their [Amazon.com: Free Book Collections](http://www.amazon.com/b?ie=UTF8&amp;node=2245146011). For MS-Windows users, there is a video describing the process at [Youtube](http://www.youtube.com/watch?v=vV_fsV3Gbao&amp;feature=youtu.be), via [a blog on the power of small instructional vidoes](http://www.toolsandtaxonomy.com/2011/08/23/creating-short-videos-that-support-learning/). The Amazon "Kindle 3" device seem to work well with Project Gutenberg titles; the Kindle DX also. Amazon used to have instructions available for downloading Project Gutenberg titles, but this seems to be gone now. They do have some free content, and an app, in their [Amazon.com: Free Book Collections](http://www.amazon.com/b?ie=UTF8&amp;node=2245146011). For MS-Windows users, there is a video describing the process at [Youtube](http://www.youtube.com/watch?v=vV_fsV3Gbao&amp;feature=youtu.be), via [a blog on the power of small instructional vidoes](http://www.toolsandtaxonomy.com/2011/08/23/creating-short-videos-that-support-learning/).
@ -106,7 +91,7 @@ The Amazon "Kindle 3" device seem to work well with Project Gutenberg titles; th
- As described above, you can first download to your computer, then connect your Kindle and copy files to it. This works with MOBI and plain text. The HTML and EPUB files we copied were not viewable on the Kindle. Audio books in MP3 format will play through the Kindle's music player, but the player is limited and does not let you see and select from available audio books. - As described above, you can first download to your computer, then connect your Kindle and copy files to it. This works with MOBI and plain text. The HTML and EPUB files we copied were not viewable on the Kindle. Audio books in MP3 format will play through the Kindle's music player, but the player is limited and does not let you see and select from available audio books.
- Project Gutenberg thanks Amazon for providing Kindle 3's and Kindle DX's for our evaluation in 2010. - Project Gutenberg thanks Amazon for providing Kindle 3's and Kindle DX's for our evaluation in 2010.
### Amazon's New File Format ### Amazon's Newer File Format
In 2015, Amazon started using the "kfx" file format for new Kindle readers. Project Gutenberg provides the MOBI format, which our download page calls "kindle" format. There are no immediate plans for Project Gutenberg to offer kfx format, but this may change in the future. Meanwhile, it appears that newer Kindle models can still utilize the other formats (MOBI, HTML and even plain text). There are many articles about how to convert files to the kfx format. [Here is one at The Digital Reader.com](http://the-digital-reader.com/2016/03/28/how-to-use-calibre-to-convert-ebooks-to-kfx-format-for-the-enhanced-kindle-typesetting/%7CHere) In 2015, Amazon started using the "kfx" file format for new Kindle readers. Project Gutenberg provides the MOBI format, which our download page calls "kindle" format. There are no immediate plans for Project Gutenberg to offer kfx format, but this may change in the future. Meanwhile, it appears that newer Kindle models can still utilize the other formats (MOBI, HTML and even plain text). There are many articles about how to convert files to the kfx format. [Here is one at The Digital Reader.com](http://the-digital-reader.com/2016/03/28/how-to-use-calibre-to-convert-ebooks-to-kfx-format-for-the-enhanced-kindle-typesetting/%7CHere)
## Nook ## Nook
@ -118,66 +103,29 @@ Beware that there are many Barnes &amp; Noble titles in print and eBooks that ar
## Kobo Reader ## Kobo Reader
Kobo has had positive reviews, and is less restrictive about where it gets content than devices from B&amp;N and Amazon. Kobo has had positive reviews, and is less restrictive about where it gets content than devices from B&amp;N and Amazon.
The \[Kobo| http://www.kobo.com/ [http://www.kobo.com/](http://www.kobo.com/)\] reader online store includes free access to 100 of the most popular Project Gutenberg titles. You need to go through the registration process to get access to the store. Direct transfer of downloaded eBooks from a computer to the Kobo did not immediately work for us, but is supposed to be supported. The Kobo supports PDF and ePub formats. Project Gutenberg would like to thank Kobo for providing free evaluation readers in 2010. The \[Kobo| http://www.kobo.com/ [https://www.kobo.com/](http://www.kobo.com/)\] reader online store includes free access to 100 of the most popular Project Gutenberg titles. You need to go through the registration process to get access to the store. Direct transfer of downloaded eBooks from a computer to the Kobo did not immediately work for us, but is supposed to be supported. The Kobo supports PDF and EPUB formats, and has a simple built-in Web browser that can be used to read eBooks online. Project Gutenberg would like to thank Kobo for providing free evaluation readers in 2010.
## Android ## Android
The Android operating system is found on many phones and tablets. The specific features and applications varies, and there are often customizations to Android that change functionality. For the most part, however, Android devices include Web browsers that can be used to read Project Gutenberg's text and HTML eBooks. For other file types, you can try copying from your computer to the device as described above. Or, try the application described below. The Android operating system is found on many phones and tablets. The specific features and applications varies, and there are often customizations to Android that change functionality. Android devices include Web browsers that can be used to read Project Gutenberg's text and HTML eBooks online.
### Free FB Reader For other file types, you can try copying from your computer to the device as described above. Use the Google Play Store or a similar source for searching for apps, to find ways to download and display EPUB and MOBI (Kindle) files.
1. Use the Android browser to navigate to [http://m.gutenberg.org](http://m.gutenberg.org)
2. Search for the book you want.
3. Select one of the EPUB files.
4. In the "Complete action using" dialog select: FBReader.
The book will start downloading in the background. After the download completes you can open the book from the Android notifications screen or the FBReader library screen.
## iPad, iPhone and iPod Touch ## iPad, iPhone and iPod Touch
The fastest way to get Project Gutenberg ebooks onto your iOS device is to use the built-in browser Your regular Web browser (Safari, etc.) can read Project Gutenberg eBooks online.
If you prefer to download, instead of reading online, the fastest way to get Project Gutenberg ebooks onto your iOS device is to use the built-in browser
to navigate to [http://m.gutenberg.org](http://m.gutenberg.org) to navigate to [http://m.gutenberg.org](http://m.gutenberg.org)
Download the EPUB format and then "open in" the preferred application. Download the EPUB format and then "open in" the preferred application.
The Apple iBookstore also contains some Project Gutenberg ebooks. Note that sometimes Apple's copy might not be the most recent copy from the Project Gutenberg site, since we often update our automated conversion procedures. If you live outside the U.S. you won't be able to access the iBookstore via the iBooks app. You can also get Project Gutenberg's eBook files onto the iPad using iTunes or other programs that transfer files to your device. This works for EPUB files, and it also works well for Project Gutenberg's MP3 audio eBooks.
You can also get Project Gutenberg's eBook files onto the iPad using iTunes. This works for EPUB files, and it also works well for Project Gutenberg's MP3 audio eBooks.
Project Gutenberg would like to thank Apple for providing devices for evaluation in 2009 and 2010. Project Gutenberg would like to thank Apple for providing devices for evaluation in 2009 and 2010.
Here are apps we know of that will work outside of the U.S., as well as within the U.S. Other apps we have heard about include **Goodreads** and **WattPad**.
### Free: Lexcycle Stanza
**Lexcycle Stanza** is a free-as-in-beer ebook reader for iPad, iPhone and iPod Touch.
1. Download the Stanza app from the Apple App Store. Use the link on the right for the US store.
2. Open the Stanza App.
3. Tap on "Get Books" and "Catalog".
4. From the list select "Project Gutenberg".
### Free: Himalaya
**Himalaya Reader** is a free ebook reader for iPad, iPhone and iPod Touch.
1. Download Himalaya reader from the iTunes store: [http://itunes.apple.com/us/app/himalaya-reader/id492689212](http://itunes.apple.com/us/app/himalaya-reader/id492689212)
2. Follow instructions within the app, or on the Web site:[http://www.himalaya-soft.com/](http://www.himalaya-soft.com/)
### Paid: Eucalyptus
[Eucalyptus](http://eucalyptusapp.com/) is a paid ebook reader for iPad, iPhone and iPod Touch. It provides over 20,000 Project Gutenberg titles, converted from text. *The Eucalyptus developers pay a proportion of their gross proceeds to Project Gutenberg as royalties.*
### Paid: MegaReader
**MegaReader** is a paid ebook reader for iPad, iPhone and iPod Touch.
1. Download QuickReader from the Apple App Store. Use the link on the right for the US store.
2. Open QuickReader and select "Normal Reading" or "Speed Reading".
3. Select "Download Books".
4. From the list select "Project Gutenberg".
### Paid: QuickReader
**QuickReader** is a paid ebook reader for iPad, iPhone and iPod Touch. It implements a speed reading technique that teaches you how to read faster.
1. Download QuickReader from the Apple App Store. Use the link on the right for the US store.
2. Open QuickReader and select "Normal Reading" or "Speed Reading".
3. Select "Download Books".
4. From the list select "Project Gutenberg".
## Suggestions from Project Gutenberg Founder Michael Hart ## Suggestions from Project Gutenberg Founder Michael Hart
Michael Hart was a proponent of eBooks on mobile devices. He offered these ideas in February 2010. This guidance might not be directly applicable to all of today's portable devices. Michael Hart wanted to encourage you to try the [QiOO Mobile format](/wiki/Gutenberg:Help_on_Bibliographic_Record_Page#QiOO_Mobile) for mobile phones. Michael Hart was a proponent of eBooks on mobile devices. He offered these ideas in February 2010. This guidance might not be directly applicable to all of today's portable devices. Michael Hart wanted to encourage you to try the [QiOO Mobile format](/wiki/Gutenberg:Help_on_Bibliographic_Record_Page#QiOO_Mobile) for mobile phones.
I'm writing this because 90% of the questions we receive I'm writing this because 90% of the questions we receive
at help@ pglaf.org are about buying dedicated eReaders at at *help @ pglaf.org* are about buying dedicated eReaders at
prices from $200 to over $1,000. prices from $200 to over $1,000.
Before actually plunking down that much money, I suggest trying reading Project Gutenberg and other eBooks on the Before actually plunking down that much money, I suggest trying reading Project Gutenberg and other eBooks on the

View File

@ -12,7 +12,7 @@ Project Gutenberg's collection is focused on older literary works for which copy
Instead, our partner, the World Library Foundation runs [self.gutenberg.org](http://self.gutenberg.org), the Project Gutenberg self-publishing portal. This is a collection of author-contributed works. Works are generally submitted in PDF format, and all ownership remains with the author. The self-publishing portal subscribes to the Project Gutenberg principle of unlimited, free redistribution of all works. Instead, our partner, the World Library Foundation runs [self.gutenberg.org](http://self.gutenberg.org), the Project Gutenberg self-publishing portal. This is a collection of author-contributed works. Works are generally submitted in PDF format, and all ownership remains with the author. The self-publishing portal subscribes to the Project Gutenberg principle of unlimited, free redistribution of all works.
## Submitting to the Self-Publishing Portal ## Submitting to the Self-Publishing Portal
1. Visit http://self.gutenberg.org 1. Visit [self.gutenberg.org](http://self.gutenberg.org)
2. Select "Get Published" 2. Select "Get Published"
3. Select "Individual Registration" and get your username set up (elibrary card). 3. Select "Individual Registration" and get your username set up (elibrary card).
4. And then, when you go back to "Get Published" you will have ability to upload your book, and see upload status. 4. And then, when you go back to "Get Published" you will have ability to upload your book, and see upload status.
@ -25,8 +25,9 @@ The review process takes a week or two, and then your author portal will be upda
Due to the size of the database at World Library, it can take a month or even longer for new items to be searchable. You can check status of your book upload, in your account dashboard ("My Uploads"). Due to the size of the database at World Library, it can take a month or even longer for new items to be searchable. You can check status of your book upload, in your account dashboard ("My Uploads").
Note that the World Library Foundation, which operates the self-publishing portal, has a helpdesk for support and any trouble you might encounter. Please contact them directly: Support *@ worldlibrary.org*. Note that the World Library Foundation, which operates the self-publishing portal, has a helpdesk for support and any trouble you might encounter. Please contact them directly: *support @ worldlibrary.org*.
## Why does Project Gutenberg not accept contemporary works?
## Why did Project Gutenberg stop accepting contemporary works?
Michael Hart, Project Gutenberg's founder, was a great believer in experimentation and pushing limits. As one of the earliest active sites for books, Project Gutenberg was a magnet for books in every possible format, and many copyrighted items were added with permission of the author. Michael Hart, Project Gutenberg's founder, was a great believer in experimentation and pushing limits. As one of the earliest active sites for books, Project Gutenberg was a magnet for books in every possible format, and many copyrighted items were added with permission of the author.
Today, there are many more mechanisms for authors to distribute their works electronically. Project Gutenberg's website does not have, and will not have, the needed features and services for contemporary authors. For example, we do not accept works in Word or PDF (instead, master formats must include HTML, text, TeX and/or RsT). Another example is that our processes of putting new eBooks online is laborious, and is not a self-service process. This is simply not up to par with modern publishing platforms. Today, there are many more mechanisms for authors to distribute their works electronically. Project Gutenberg's website does not have, and will not have, the needed features and services for contemporary authors. For example, we do not accept works in Word or PDF (instead, master formats must include HTML, text, TeX and/or RsT). Another example is that our processes of putting new eBooks online is laborious, and is not a self-service process. This is simply not up to par with modern publishing platforms.

View File

@ -17,48 +17,52 @@ Welcome to Project Gutenberg
## Find Free eBooks ## Find Free eBooks
- [Book Search](/ebooks/). - [Book search](/ebooks/). By author, title, subject, and more. TODO: Update menu.
- [Recently added eBooks](/ebooks/search/?query=&submit_search=Search&sort_order=release_date). - [Bookshelves](/ebooks/bookshelf/) of related eBooks. TODO: Implement.
- [Most Frequently Downloaded eBooks](/ebooks/search/?sort_order=downloads) and [Top 100 eBooks this month](/browse/scores/top). - [Browse](/browse/): Browse and search, including full-text search. TODO: Implement.
- [Bookshelves of related eBooks](:Category:Bookshelf). - [Frequently downloaded](/ebooks/search/?sort_order=downloads) and [Top 100 eBooks this month](/browse/scores/top). TODO: Implement. TODO: Fix banner image. Fix "pretty pictures."
- [New eBooks Feeds](Gutenberg:Feeds). - [Offline catalogs](/ebooks/offline_catalogs.html): handy eBook listings and metadata to consult offline.
- [Browse Catalog](/browse/): Browse and search, including full-text search. - [Recently added](/ebooks/search/?query=&submit_search=Search&sort_order=release_date). The latest new and updated eBooks.
- [Offline Catalogs](Gutenberg:Offline Catalogs): handy eBook Listings to consult offline. - Visit [self.gutenberg.org](http://self.gutenberg.org) for free eBooks by contemporary authors.
- Visit [self.gutenberg.org](http://self.gutenberg.org), for free eBooks by contemporary authors.
## Help and Information ## Help and Information
- [Tablets, Phones and eReaders How-To](/help/mobile.html): Using tablets, Kindle, Nook, cell phone, and other mobile devices and readers.
- [How-To and FAQs](/help/): In depth information about many topics. - [How-To and FAQs](/help/): In depth information about many topics.
- [Tablets, phones and eReaders How-To](/help/mobile.html): Using tablets, Kindle, Nook, cell phone, and other mobile devices and readers.
## How to Help ## How to Help
- Join [Distributed Proofreaders](https://www.pgdp.net), the main source of new Project Gutenberg eBooks. Getting started is easy, and just a page a day will help! - [Distributed Proofreaders](https://www.pgdp.net) welcomes new volunteers. This is the main source of new Project Gutenberg eBooks. Getting started is easy, and just a page a day will help!
- [Report errors, bugs, typos](/help/errata.html), to help improve Project Gutenberg eBooks. - [Fix and improve](/help/errata.html) Project Gutenberg by reporting errors, bugs, typos, and suggesting changes.
- [LibriVox](https://librivox.org): Help record audio books. - Record audiobooks with our affiliate, [LibriVox](https://librivox.org).
## Special Areas ## Special Areas
- [About Project Gutenberg](/about/). - [About Project Gutenberg](/about/).
- What does [free eBook](/about/background/free_ebook.html) (No Cost or Freedom?) mean?
- [Permissions, copyright, licensing, and trademark information](/policy/permission.html).
- [Linking to Project Gutenberg](/information/linking_pages.html) and [roboting or crawling](/policy/robot_access.html) the site.
- [Donating to Project Gutenberg](/donate/). - [Donating to Project Gutenberg](/donate/).
- [Partners and Affiliates](/about/partners_affiliates.html). - [Feeds](/ebooks/feeds.html) of new eBooks.
- [Linking to Project Gutenberg](/information/linking_pages.html) and [roboting or crawling](/policy/robot_access.html) the site.
- [Partners and affiliates](/about/partners_affiliates.html).
- [Permissions, copyright, licensing, and trademark information](/policy/permission.html).
- What does [free eBook](/about/background/free_ebook.html) (No Cost or Freedom?) mean?
## Terms of Use ## Terms of Use
<div class="box_shadow"> <div class="box_shadow">
Project Gutenberg eBooks may be freely used in the United States because most are not protected by U.S. copyright law, usually because their copyrights have expired. They may not be free of copyright in other countries. Readers outside of the United States must check the copyright terms of their countries before downloading or redistributing eBooks. We also have a number of copyrighted titles, for which the copyright holder has given permission for unlimited non-commercial worldwide use. Project Gutenberg eBooks may be freely used in the United States because most are not protected by U.S. copyright law. They may not be free of copyright in other countries. Readers outside of the United States must check the copyright terms of their countries before accessing, downloading or redistributing eBooks. We also have a number of copyrighted titles, for which the copyright holder has given permission for unlimited non-commercial worldwide use.
</div>
</div>
<div class="box_shadow"> <div class="box_shadow">
The Project Gutenberg website is for human users only. Any real or perceived use of automated tools to access the website will result in a block of your IP address. This site utilizes cookies, captchas and related technologies to help assure the site is maximally available for human users only. The Project Gutenberg website is for human users only. Use of automated tools to access the website may trigger a block of your access. This site utilizes cookies, captchas and related technologies to help assure the site is maximally available for human users.
</div> </div>
## Find Project Gutenberg on social media
- Facebook: [https://www.facebook.com/project.gutenberg](https://www.facebook.com/project.gutenberg)
- Facebook news feed of new eBooks: [https://www.facebook.com/gutenberg.new](https://www.facebook.com/gutenberg.new)
- Twitter [https://twitter.com/gutenberg\_org](https://twitter.com/gutenberg_org) @gutenberg\_org
- Twitter news feed of new eBooks: [https://twitter.com/gutenberg\_new](https://twitter.com/gutenberg_new) @gutenberg\_new
## Contact Info ## Contact Info
- [Contact Information](/about/contact_information.html): How to get in touch. - [Contact Information](/about/contact_information.html): How to get in touch.

View File

@ -44,12 +44,13 @@ additions, such as transcriber's notes, indices, improvements or
supplements to artwork, or new cover art, are granted permanently to supplements to artwork, or new cover art, are granted permanently to
the public domain. the public domain.
Some types of items which are ineligible include: - Scans of books or Some types of items which are ineligible include:
other sources that have not been converted to machine-readable text - Scans of books or other sources that have not been converted to
and undergone proofreading and formatting to the requirements of the machine-readable text and undergone proofreading and formatting to the
upload portal. - Unpublished contemporary items, even if they are requirements of the upload portal.
granted to the public domain by the author. - Items that were not - Unpublished contemporary items, even if they are granted to the
previously published or distributed. public domain by the author.
- Items that were not previously published or distributed.
## How is a Project Gutenberg eBook related to the source(s) it was based on? ## How is a Project Gutenberg eBook related to the source(s) it was based on?

View File

@ -7,6 +7,8 @@ permalink: /policy/license.html
The Project Gutenberg License The Project Gutenberg License
============================= =============================
Also see the [/policy/permissions.html](permissions) page, which provides additional detail on use of the license, and additional related topics.
<div class="contents"> <div class="contents">
<ol> <ol>
<li ><a href="#the-project-gutenberg-license-explained-informative">The Project Gutenberg License Explained (informative)</a> <li ><a href="#the-project-gutenberg-license-explained-informative">The Project Gutenberg License Explained (informative)</a>

View File

@ -29,26 +29,25 @@ Direct links to files will be redirected to the appropriate catalog page. Direct
But if you run an independent search site for our books read the [independent search site section](#independent-project-gutenberg-search-sites) below. But if you run an independent search site for our books read the [independent search site section](#independent-project-gutenberg-search-sites) below.
## Canonical URLs to Books and Authors ## Canonical URLs to Books and Authors
If you want to link to one of our books or authors please use only the URL formats described here. If you want to link to one of our books or authors please use only the URL formats described here. Either http:// or https:// is supported.
- **http://www.gutenberg.org/ebooks/12345** - **https://www.gutenberg.org/ebooks/12345**
This URL will always lead to the catalog page of the ebook with the number 12345 (replace 12345 with the ebook number you are interested in). This URL will always lead to the catalog page of the ebook with the number 12345 (replace 12345 with the ebook number you are interested in).
- **http://www.gutenberg.org/author/Mark_Twain** - **https://www.gutenberg.org/author/Mark_Twain**
This URL will always lead to a list of all books by the author "Mark Twain". (Replace Mark_Twain with the author you are interested in. Use an underscore or a plus sign in place of spaces.) This URL will always lead to a list of all books by the author "Mark Twain". (Replace Mark_Twain with the author you are interested in. Use an underscore or a plus sign in place of spaces.)
- Use **http://www.gutenberg.org/author/Henry_James_(1843-1916)** - Use **https://www.gutenberg.org/author/Henry_James_(1843-1916)**
if you have to disambiguate between authors. If only one date is known or certain use (1843-) or (-1916). The parens and the hyphen are required. if you have to disambiguate between authors. If only one date is known or certain use (1843-) or (-1916). The parens and the hyphen are required.
## Image Inlining ## Image Inlining
You may use all images from our ebooks not protected by U.S. copyright law on your site. If the book is not protected by U.S. copyright law, the images in the book are also not protected by U.S. copyright law. Read the license inside the book to find out if the book is protected by U.S. copyright law. However **you must copy the image** and host it on your site, not link to the image hosted on our site. (Use your favorite search engine to identify free image hosting services, if needed.) You may use all images from our ebooks not protected by U.S. copyright law on your site. If the book is not protected by U.S. copyright law, the images in the book are also not protected by U.S. copyright law. Read the license inside the book to find out if the book is protected by U.S. copyright law. However **you must copy the image** and host it on your site, not link to the image hosted on our site.
Our servers are configured not to serve images to third-party websites. Therefore your users may only see a warning notice instead of the intended picture. Our servers are configured not to serve images to third-party websites. Therefore your users may only see a warning notice instead of the intended picture.
## Independent Project Gutenberg Search Sites ## Independent Project Gutenberg Search Sites
Some sites provide their own search engine for Project Gutenberg eBooks. Some of them are dedicated to Project Gutenberg only, other include books from a variety of free collections in their database. Some sites provide their own search engine for Project Gutenberg eBooks. Some of them are dedicated to Project Gutenberg only, other include books from a variety of free collections in their database.
Note that the Project Gutenberg Catalog is now [available in machine-readable format](/wiki/Gutenberg:Feeds). Please use one of those files to feed your database instead of [roboting our site](/information/robot_access.html). Note that the Project Gutenberg Catalog is now [available in machine-readable format](/offline.html). Please use one of those files to feed your database instead of [roboting our site](/policy/robot_access.html).

View File

@ -4,8 +4,8 @@ title: Permission How-to | Project Gutenberg
permalink: /policy/permission.html permalink: /policy/permission.html
--- ---
Permission How-To Project Gutenberg Permissions, Licensing and other Common Requests
================= ==================================================================
<div class="contents"> <div class="contents">
<ol> <ol>
@ -23,15 +23,13 @@ Permission How-To
<li><a href="#US_only">US only</a></li> <li><a href="#US_only">US only</a></li>
<li><a href="#No_.22sweat_of_the_brow.22">No "sweat of the brow"</a></li> <li><a href="#No_.22sweat_of_the_brow.22">No "sweat of the brow"</a></li>
<li><a href="#For_copyrighted_content">For copyrighted content</a></li> <li><a href="#For_copyrighted_content">For copyrighted content</a></li>
<li><a href="#Commercial_use_of_Project_Gutenberg_trademark">15 Commercial use of Project Gutenberg trademark</a></li> <li><a href="#Commercial_use_of_Project_Gutenberg_trademark">Commercial use of Project Gutenberg trademark</a></li>
<li><a href="#Higher_resolution_images">Higher resolution images</a></li> <li><a href="#Higher_resolution_images">Higher resolution images</a></li>
<li><a href="#More_details_on_items">More details on items</a></li> <li><a href="#More_details_on_items">More details on items</a></li>
<li><a href="#Reporting_errata">Reporting errata</a></li> <li><a href="#Reporting_errata">Reporting errata</a></li>
</ol> </ol>
</div> </div>
## Project Gutenberg Permissions, Licensing and other Common Requests
## Overview ## Overview
Project Gutenberg receives many requests for permissions to use eBooks, images from eBooks, or extracts. Most such requests are not needed, since permission is included in the items themselves (even for commercial use). This How-To provides responses to the most common inquiries. If your inquiry is not addressed, please email [Prof. Newby](/about/contact_information.html) with your permission requests. Responses are typically received within a day or so (or, re-send your request!). Project Gutenberg receives many requests for permissions to use eBooks, images from eBooks, or extracts. Most such requests are not needed, since permission is included in the items themselves (even for commercial use). This How-To provides responses to the most common inquiries. If your inquiry is not addressed, please email [Prof. Newby](/about/contact_information.html) with your permission requests. Responses are typically received within a day or so (or, re-send your request!).
@ -42,7 +40,7 @@ Most permission requests we receive did not need to be made. The vast majority o
"As you please" includes any commercial use, republishing in any format, making derivative works or performances, etc. Read more about the public domain in [Wikipedia](https://en.wikipedia.org/wiki/Public_domain). "As you please" includes any commercial use, republishing in any format, making derivative works or performances, etc. Read more about the public domain in [Wikipedia](https://en.wikipedia.org/wiki/Public_domain).
## Terms of Use ## Terms of Use
All use of the web site and content at www.gutenberg.org is subject to its Terms of Use. Find them on the main page of [/ www.gutenberg.org]. All use of the web site and content at www.gutenberg.org is subject to its Terms of Use. Find them on the main page of [www.gutenberg.org](/).
## Trademark Permission to "Trade On" the Project Gutenberg name ## Trademark Permission to "Trade On" the Project Gutenberg name
The name "Project Gutenberg" is a registered trademark. The [/license Small Print License] guides terms of use. Basically, you need to pay royalties for commercial use (mentioned below). This restriction is mainly to prevent you selling things that might be mis-perceived as being sold and/or supported by Project Gutenberg, when Project Gutenberg has no involvement. It is intended to recognize the value of the Project Gutenberg name. The name "Project Gutenberg" is a registered trademark. The [/license Small Print License] guides terms of use. Basically, you need to pay royalties for commercial use (mentioned below). This restriction is mainly to prevent you selling things that might be mis-perceived as being sold and/or supported by Project Gutenberg, when Project Gutenberg has no involvement. It is intended to recognize the value of the Project Gutenberg name.
@ -68,7 +66,7 @@ No permission is needed to use quotes from Project Gutenberg items (in the US, t
It is always OK to cite Project Gutenberg as the publication source (see below for how to cite), and it is also OK to not cite Project Gutenberg: your choice. It is always OK to cite Project Gutenberg as the publication source (see below for how to cite), and it is also OK to not cite Project Gutenberg: your choice.
## Copyright page and trademarks from Source ## Copyright page and trademarks from Source
Sometimes an eBook will include a transcription or image of the original title page, verso (obverse) or other pages from a source print book used for the eBook. This may include a copyright statement, which will usually be before 1964 (see our ["copyright how-to"](/how_to/copyright.html) for details). This does not mean that item is still copyrighted. The header/footer in the eBook from Project Gutenberg will mention that such items are in the public domain in the US. Sometimes an eBook will include a transcription or image of the original title page, verso (obverse) or other pages from a source print book used for the eBook. This may include a copyright statement, which will usually be before 1964 (see our ["copyright how-to"](/help/copyright.html) for details). This does not mean that item is still copyrighted. The header/footer in the eBook from Project Gutenberg will mention that such items are in the public domain in the US.
Similarly, eBooks might include images or text that are (or were) trademarks in the US or elsewhere. This might include print publisher names or marks, publication associations, or marks depicted as images or words within the eBooks. Project Gutenberg is providing such items "as is," with no representation of ownership, or whether any such marks are still active. Similarly, eBooks might include images or text that are (or were) trademarks in the US or elsewhere. This might include print publisher names or marks, publication associations, or marks depicted as images or words within the eBooks. Project Gutenberg is providing such items "as is," with no representation of ownership, or whether any such marks are still active.
@ -94,7 +92,7 @@ We also do not process forms that somehow confirm non-copyright status. If you d
PG is entirely based in the US, and we follow the United States laws for copyright. Not all items that are public domain in the US are public domain in other countries, and vice versa. If you are operating outside of the US, you should get professional guidance on how to proceed for things like redistributing Project Gutenberg's content. For basic information about copyright elsewhere, try this link to the [Online books page](http://onlinebooks.library.upenn.edu/okbooks.html). PG is entirely based in the US, and we follow the United States laws for copyright. Not all items that are public domain in the US are public domain in other countries, and vice versa. If you are operating outside of the US, you should get professional guidance on how to proceed for things like redistributing Project Gutenberg's content. For basic information about copyright elsewhere, try this link to the [Online books page](http://onlinebooks.library.upenn.edu/okbooks.html).
## No "sweat of the brow" ## No "sweat of the brow"
Project Gutenberg claims no copyright for markup, formatting, spelling modernization, etc., and neither can you (at least in the United States). See our [No Sweat of the Brow How-To](/how_to/no_sweat_copyright.html) Project Gutenberg claims no copyright for markup, formatting, spelling modernization, etc., and neither can you (at least in the United States). See our [No Sweat of the Brow How-To](/policy/no_sweat_copyright.html)
## For copyrighted content ## For copyrighted content
There are thousands of items in the Project Gutenberg collection which are still under copyright protection. Each copyrighted item is clearly indicated as copyrighted in the eBook's header. Unless there is an included license with the copyrighted item (such as a creative commons license), you will need to contact the copyright holder for any needed permission. Project Gutenberg cannot do this on your behalf, and does not have any ability to sublicense copyrighted works. There are thousands of items in the Project Gutenberg collection which are still under copyright protection. Each copyrighted item is clearly indicated as copyrighted in the eBook's header. Unless there is an included license with the copyrighted item (such as a creative commons license), you will need to contact the copyright holder for any needed permission. Project Gutenberg cannot do this on your behalf, and does not have any ability to sublicense copyrighted works.

View File

@ -9,13 +9,15 @@ Privacy Policy
If you read the Gutenberg website, no more information is collected than is typically collected in server logs by websites in general. If you read the Gutenberg website, no more information is collected than is typically collected in server logs by websites in general.
Specifically, all usage of www.gutenberg.org or any domain in PGLAF.org is intended to be anonymous. Your name, or any other identifying information, is never requested. However, your IP address and requests from that address are saved by our servers, for periodic analysis of website traffic, quality assurance, and aggregate reporting. Note that Project Gutenberg does not control any mirrors except those at www.gutenberg.org and any domain in PGLAF.org, and those mirrors might have different procedures. Specifically, all usage of www.gutenberg.org or any domain in PGLAF.org is intended to be anonymous. Your name, or any other identifying information, is never requested. However, your IP address and requests from that address are recorded by our servers, for periodic analysis of website traffic, quality assurance, and aggregate reporting. All website access logs are automatically and permanently deleted after 60 days.
Note that Project Gutenberg does not control any mirrors except those at www.gutenberg.org and any domain in PGLAF.org, and those mirrors might have different procedures.
## Uses of Cookies and Captchas ## Uses of Cookies and Captchas
In order to assure the site is available for human users, not robots or third-party sites, this site uses cookies, captchas, and related techniques to apply our [Terms of Use](/jekyll/policy/terms_of_use.html). See the Terms of Use for alternate means to acquire Project Gutenberg content and metadata (i.e., mirrors, offline catalogs, and OPDS) if you cannot abide by these techniques. In order to assure the site is available for human users, not robots or third-party sites, this site may make use of cookies, captchas, and related techniques to apply our [Terms of Use](/policy/terms_of_use.html). See the Terms of Use for alternate means to acquire Project Gutenberg content and metadata (i.e., mirrors, offline catalogs, and OPDS) if you cannot abide by these techniques.
## Contributing Authors ## Contributing Authors
Any content, including errata reports and fixes, are donated to the public domain. If you write something, assume that it will be retained forever. This includes articles, user pages and talk pages. Any content, including errata reports and fixes, are donated to the public domain. If you write something, assume that it will be retained forever. This includes articles, user pages and talk pages.
## Linkes to Third Party Websites ## Linkes to Third Party Websites
This includes Google, Facebook, Twitter, Dropbox and maybe more. Project Gutenberg does link to third party sites wherever users have come to expect this. Many of those sites are notorious wholesale collectors of private data, and it has been reported that such data are freely shared with national spy organizations and others. However, we are very careful to link in a manner that does not allow those third party websites to see what you are doing on Project Gutenberg unless you explicitly click on one of those links. If you click on a third party link, you will leave the Project Gutenberg website, and we cannot tell you what the other site will do with your data. The Project Gutenbeg website has links to external sites that it does not control and has no relationship to. Some of those sites are notorious wholesale collectors of private data, and it has been reported that such data are freely shared with national spy organizations and others. We strive to link in a manner that does not allow those third party websites to see what you are doing on Project Gutenberg unless you explicitly select one of those links. When you select a third party link, you will leave the Project Gutenberg website, and we cannot tell you what the other site will do with your data.