~ldn/The_MagPi_Metadata

6c63fb501479c22af4a9d1b60c2f52f1d9cce311 — ldn 4 months ago 84f9c45
reflect new work flow in README file
1 files changed, 17 insertions(+), 12 deletions(-)

M README.md
M README.md => README.md +17 -12
@@ 16,11 16,13 @@ itself can be found or ordered at https://magpi.raspberrypi.com/

## File Editing

Git does not support locking so create an empty file in the CSV
directory and add it to the repository to reserve it for work.
Then commit the changes once it has been edited.  The naming 
convention for the metadata files is "articles.nnn.csv" where nnn
is the issue number.  
All the metadata is now in a single file.

Previously, since Git does not support locking it was necessary to 
create an empty file in the CSV directory and add it to the repository 
to reserve it for work.  Then the changes were commmitted once it has 
been edited.  The naming convention for the metadata files was 
"articles.nnn.csv" where nnn is the issue number.

Make a read-only clone with Git:



@@ 31,7 33,7 @@ git clone https://git.sr.ht/~ldn/The_MagPi_Metadata

Use UTF-8 "CSV" with tabs between columns, one record per line.
The working format can be anything, such as OpenDocument Format,
but the result must be exported as tab-delimited "CSV".  
but the result must be exported as tab-delimited "CSV".


## File Contents


@@ 41,6 43,7 @@ so a separate file is needed for each published magazine.

The columns are:

 - Review
 - Number
 - Page
 - Section


@@ 49,12 52,14 @@ The columns are:
 - Maker
 - Author

Month and year of publication can be looked up from the number. 
Month and year of publication can be looked up from the number.  Review 
refers to the number of times the record has been inspected for 
correctness.


## SQLite3 Database Structure

The metadata is gathered as tab-delimited text files above for import 
The metadata is gathered as a tab-delimited text file above for import 
into an SQLite3 database table for searching via programs. That table is 
for the article-specific metadata, another table is edited manually to 
track the year and month for each issue.  A third table would be needed 


@@ 81,7 86,7 @@ create unique index issue on dates(number);
create index number on metadata(number);

There is a script n the ./bin directory for bulk loading of the
metadata.  However, the gist is:
metadata from the independent files.  However, the gist was:

.mode csv
.separator "\t"


@@ 91,6 96,6 @@ metadata.  However, the gist is:

## Reading The MagPi in PDF Form

The PDF index on the left often misses articles.  It is essential
to scroll through each page to ensure that nothing is missed.

The PDF index on the left often misses articles.  It is essential to 
scroll through the whole PDF and each page to ensure that nothing is 
missed.