From 5152fea748caaadb3ad5dc20e695b98f1960a843 Mon Sep 17 00:00:00 2001 From: Alice DuVivier Date: Fri, 2 Nov 2018 22:18:41 -0600 Subject: [PATCH 1/4] testing bib file --- doc/source/master_list.bib | 25 +------------------------ 1 file changed, 1 insertion(+), 24 deletions(-) diff --git a/doc/source/master_list.bib b/doc/source/master_list.bib index f78ac384c..e7cfa21da 100644 --- a/doc/source/master_list.bib +++ b/doc/source/master_list.bib @@ -62,18 +62,6 @@ @string{PTRSA= % **************************************** % List of individual sources and their meta data % **************************************** -% ** example template ** -%@Article{LASTNAME1YY -% author = "F.N.1 LASTNAME1 and F.N.2 LASTNAME2 and ...", %%% NOTE: REQUIRED FORMAT IS ONLY " " -% title = "{TITLE}", %%% NOTE: REQUIRED FORMAT IS "{ }" -% journal = ACRONYMN, %%% NOTE: REQUIRED FORMAT USES ACRONYM WITHOUT {} -% year = {YYYY}, -% volume = {N}, -% issue = {I}, -% pages = {PP-PP}, -% url = {http://dx.doi.org/XXXXX} -% } - @incollection{Assur58, author = "A. Assur", title = "Composition of sea ice and its tensile strength", @@ -879,15 +867,4 @@ @Article{Roberts18 year = {2018}, volume = {376}, url = {http://dx.doi.org/10.1098/rsta.2017.0344} -} -% ** example template ** -%@Article{LASTNAME1YY -% author = "F.N.1 LASTNAME1 and F.N.2 LASTNAME2 and ...", %%% NOTE: REQUIRED FORMAT IS ONLY " " -% title = "{TITLE}", %%% NOTE: REQUIRED FORMAT IS "{ }" -% journal = ACRONYMN, %%% NOTE: REQUIRED FORMAT USES ACRONYM WITHOUT {} -% year = {YYYY}, -% volume = {N}, -% issue = {I}, -% pages = {PP-PP}, -% url = {http://dx.doi.org/XXXXX} -% } \ No newline at end of file +} \ No newline at end of file From 67361da35dad8d9627b23c79d8b4c8c9dc69b06b Mon Sep 17 00:00:00 2001 From: Alice DuVivier Date: Fri, 2 Nov 2018 22:39:00 -0600 Subject: [PATCH 2/4] fixing how to add new entries --- doc/README.txt | 23 +++++++++++++++++++++++ doc/source/README.txt | 23 +++++++++++++++++++++++ doc/source/master_list.bib | 17 +++++++++++------ 3 files changed, 57 insertions(+), 6 deletions(-) create mode 100644 doc/README.txt create mode 100644 doc/source/README.txt diff --git a/doc/README.txt b/doc/README.txt new file mode 100644 index 000000000..09ef1d19e --- /dev/null +++ b/doc/README.txt @@ -0,0 +1,23 @@ +Format for a standard journal entry into master_list.bib + +% ** example template ** +@Article{LASTNAME1YY + author = "F.N.1 LASTNAME1 and F.N.2 LASTNAME2 and ...", + title = "{TITLE}", + journal = ACRONYMN, + year = {YYYY}, + volume = {N}, + issue = {I}, + pages = {PP-PP}, + url = {http://dx.doi.org/XXXXX} +} + + +NOTES: +- Format for "author" entry you must use just quote marks " " around list. + The names are separated just by the word 'and' +- Format for "title" is to use BOTH quotes and curly braces "{ }" +- Format for "journal" MUST use an acronym defined at the top of master_list.bib. + Do not use anything around the acronym +- Format for "year", "volume", "issue", "pages", and "url" are all just curly braces { } +- All entries must have a comma at the end EXCEPT after final entry (url) diff --git a/doc/source/README.txt b/doc/source/README.txt new file mode 100644 index 000000000..09ef1d19e --- /dev/null +++ b/doc/source/README.txt @@ -0,0 +1,23 @@ +Format for a standard journal entry into master_list.bib + +% ** example template ** +@Article{LASTNAME1YY + author = "F.N.1 LASTNAME1 and F.N.2 LASTNAME2 and ...", + title = "{TITLE}", + journal = ACRONYMN, + year = {YYYY}, + volume = {N}, + issue = {I}, + pages = {PP-PP}, + url = {http://dx.doi.org/XXXXX} +} + + +NOTES: +- Format for "author" entry you must use just quote marks " " around list. + The names are separated just by the word 'and' +- Format for "title" is to use BOTH quotes and curly braces "{ }" +- Format for "journal" MUST use an acronym defined at the top of master_list.bib. + Do not use anything around the acronym +- Format for "year", "volume", "issue", "pages", and "url" are all just curly braces { } +- All entries must have a comma at the end EXCEPT after final entry (url) diff --git a/doc/source/master_list.bib b/doc/source/master_list.bib index e7cfa21da..722c40ebc 100644 --- a/doc/source/master_list.bib +++ b/doc/source/master_list.bib @@ -12,9 +12,10 @@ % * requests that you only add references that* % * are cited in the text. * % * -------* -% * See 'example' below for the format for * -% * how to enter information for new bibliographic* -% * entries. * +% * See 'example' in README.txt for new * +% * entries to the list and how to enter * +% * information for bibliography in a way * +% * required to build properly. * % * ------* % * Then put your new entry in the list below * % * which is organized as: sequential from * @@ -59,9 +60,10 @@ @string{IJHPCA= @string{PTRSA={Philos. Trans. Royal Soc. A}} -% **************************************** +% ********************************************** % List of individual sources and their meta data -% **************************************** +% For new entries, see example entry in README.txt +% ********************************************** @incollection{Assur58, author = "A. Assur", title = "Composition of sea ice and its tensile strength", @@ -867,4 +869,7 @@ @Article{Roberts18 year = {2018}, volume = {376}, url = {http://dx.doi.org/10.1098/rsta.2017.0344} -} \ No newline at end of file +} +% ********************************************** +% For new entries, see example entry in README.txt +% ********************************************** From 472abb4eed191dd03b7a5a5f1805ac31e3760628 Mon Sep 17 00:00:00 2001 From: Alice DuVivier Date: Fri, 2 Nov 2018 22:45:55 -0600 Subject: [PATCH 3/4] fixing names --- doc/{README.txt => source/BIB_TEMPLATE.txt} | 0 doc/source/README.txt | 23 --------------------- doc/source/master_list.bib | 6 +++--- 3 files changed, 3 insertions(+), 26 deletions(-) rename doc/{README.txt => source/BIB_TEMPLATE.txt} (100%) delete mode 100644 doc/source/README.txt diff --git a/doc/README.txt b/doc/source/BIB_TEMPLATE.txt similarity index 100% rename from doc/README.txt rename to doc/source/BIB_TEMPLATE.txt diff --git a/doc/source/README.txt b/doc/source/README.txt deleted file mode 100644 index 09ef1d19e..000000000 --- a/doc/source/README.txt +++ /dev/null @@ -1,23 +0,0 @@ -Format for a standard journal entry into master_list.bib - -% ** example template ** -@Article{LASTNAME1YY - author = "F.N.1 LASTNAME1 and F.N.2 LASTNAME2 and ...", - title = "{TITLE}", - journal = ACRONYMN, - year = {YYYY}, - volume = {N}, - issue = {I}, - pages = {PP-PP}, - url = {http://dx.doi.org/XXXXX} -} - - -NOTES: -- Format for "author" entry you must use just quote marks " " around list. - The names are separated just by the word 'and' -- Format for "title" is to use BOTH quotes and curly braces "{ }" -- Format for "journal" MUST use an acronym defined at the top of master_list.bib. - Do not use anything around the acronym -- Format for "year", "volume", "issue", "pages", and "url" are all just curly braces { } -- All entries must have a comma at the end EXCEPT after final entry (url) diff --git a/doc/source/master_list.bib b/doc/source/master_list.bib index 722c40ebc..2d21e3e3b 100644 --- a/doc/source/master_list.bib +++ b/doc/source/master_list.bib @@ -12,7 +12,7 @@ % * requests that you only add references that* % * are cited in the text. * % * -------* -% * See 'example' in README.txt for new * +% * See 'example' in BIB_TEMPLATE.txt for new * % * entries to the list and how to enter * % * information for bibliography in a way * % * required to build properly. * @@ -62,7 +62,7 @@ @string{PTRSA= % ********************************************** % List of individual sources and their meta data -% For new entries, see example entry in README.txt +% For new entries, see example entry in BIB_TEMPLATE.txt % ********************************************** @incollection{Assur58, author = "A. Assur", @@ -871,5 +871,5 @@ @Article{Roberts18 url = {http://dx.doi.org/10.1098/rsta.2017.0344} } % ********************************************** -% For new entries, see example entry in README.txt +% For new entries, see example entry in BIB_TEMPLATE.txt % ********************************************** From d7197d662265704269b6d4773f05b0d9dfc38204 Mon Sep 17 00:00:00 2001 From: Alice DuVivier Date: Fri, 2 Nov 2018 22:48:36 -0600 Subject: [PATCH 4/4] adjusting template --- doc/source/BIB_TEMPLATE.txt | 19 ++++++++++++------- 1 file changed, 12 insertions(+), 7 deletions(-) diff --git a/doc/source/BIB_TEMPLATE.txt b/doc/source/BIB_TEMPLATE.txt index 09ef1d19e..a874f88f9 100644 --- a/doc/source/BIB_TEMPLATE.txt +++ b/doc/source/BIB_TEMPLATE.txt @@ -14,10 +14,15 @@ Format for a standard journal entry into master_list.bib NOTES: -- Format for "author" entry you must use just quote marks " " around list. - The names are separated just by the word 'and' -- Format for "title" is to use BOTH quotes and curly braces "{ }" -- Format for "journal" MUST use an acronym defined at the top of master_list.bib. - Do not use anything around the acronym -- Format for "year", "volume", "issue", "pages", and "url" are all just curly braces { } -- All entries must have a comma at the end EXCEPT after final entry (url) +- Format for "author" entry you must use just + quote marks " " around list. The names are + separated just by the word 'and' +- Format for "title" is to use BOTH quotes and + curly braces "{ }" +- Format for "journal" MUST use an acronym + defined at the top of master_list.bib. Do not + use anything around the acronym +- Format for "year", "volume", "issue", "pages", + and "url" are all just curly braces { } +- All entries must have a comma at the end EXCEPT + after final entry (url)