Difference between revisions of "Code4Lib Journal Entries in Directory of Open Access Journals"

Latest revision as of 15:49, 21 April 2023

There are two ways to get metadata into the Directory of Open Access Journals: 1) by hand, or 2) through the use of an XML file. (UPDATE 2014-01-22: DOAJ says, "Until further notice, publishers will only able to upload article metadata to us, using an XML file...Temporarily, publishers will no longer be able to submit metadata to us on an article-by-article basis. If you are unable to produce the XML file, we suggest that you wait until we have reinstated the article-by-article upload feature.") Before you do either method, please keep in mind the following things:

We chose not to have volume numbers, just issue numbers. Issue numbers will just keep incrementing.
We decided that the "record number" for an article is the article-id that shows up in the WordPress URI. That is, they are not sequential, numbers are skipped. That's fine. So there is no 'start page', but there is a 'record number'; there is no 'end page'.
Enter the abstract and authors affiliation exactly as found in our published articles.
Enter keywords if there are any. If not, leave this blank

Semi-Automated

To use the XML file to do data entry:

make sure the WordPress databases is up-to-date,
go to http://journal.code4lib.org/issues/issue#/feed/doaj (replace # with the current issue number) to get the necessary XML. (eg http://journal.code4lib.org/issues/issue5/feed/doaj.)
edit the XML so each author is in a element by themselves (as of April 2023 this seems to happen automatically),
validate the XML against the Directory's schema,
- Download a copy of the DOAJ schema, http://www.doaj.org/static/doaj/doajArticles.xsd , to your computer along with the XML file you've just edited.
- Upload both files to a schema validator service such as http://tools.decisionsoft.com/schemaValidate/ (as of April 2023 the xsd gave an error, but journal xml seemed fine and did load to doaj)
Go to the URL listed in the article tracking spreadsheet (administrivia tab) and upload the fruits of your labors.

Note: if there are any sub-elements in the XML fields (e.g., HTML tags), the document will not validate. Also of note, Windows often creates character encoding that breaks with UTF-8, throwing an error on validation.

More info about the feed and how to customize the XML for import into DOAJ:

--Eric Lease Morgan 10:42, 28 May 2008 (PDT)

@@ Line 1: / Line 1: @@
-For now we are entering article metadata into DOAJ by hand. This will eventually put us in OAISter, as well as DOAJ's own article-level search function, injecting our articles into the wider findable world.
+There are two ways to get metadata into the Directory of Open Access Journals: 1) by hand, or 2) through the use of an XML file. ''(UPDATE 2014-01-22: DOAJ says, "Until further notice, publishers will only able to upload article metadata to us, using an XML file...Temporarily, publishers will no longer be able to submit metadata to us on an article-by-article basis. If you are unable to produce the XML file, we suggest that you wait until we have reinstated the article-by-article upload feature.")''
+Before you do either method, please keep in mind  the following things:
-Some metadata peculariaties of ours that come up when entering data:
+# We chose not to have volume numbers, just issue numbers. Issue numbers will just keep incrementing.
-) We chose not to have volume numbers, just issue numbers. Issue
+# We decided that the "record number" for an article is the article-id that shows up in the WordPress URI. That is, they are not sequential, numbers are skipped. That's fine. So there is no 'start page', but there is a 'record number'; there is no 'end page'.
-numbers will just keep incrementing.
+# Enter the abstract and authors affiliation exactly as found in our published articles.
+# Enter keywords if there are any. If not, leave this blank
-) We decided that the "record number" for an article is the article-id
+==Semi-Automated==
-that shows up in the WordPress URI. That is, they are not sequential,
-numbers are skipped. That's fine. So there is no 'start page', but there
-is a 'record number'; there is no 'end page'.
-) Enter the abstract and authors affiliation exactly as found
+To use the XML file to do data entry:
-in our published articles.
+# make sure the WordPress databases is up-to-date,
+# go to http://journal.code4lib.org/issues/issue#/feed/doaj (replace # with the current issue number) to get the necessary XML. (eg http://journal.code4lib.org/issues/issue5/feed/doaj.)
+# edit the XML [http://journal.code4lib.org/doaj/ so each author is in a element by themselves] (as of April 2023 this seems to happen automatically),
+# validate the XML against the Directory's schema,
+#* Download a copy of the DOAJ schema, http://www.doaj.org/static/doaj/doajArticles.xsd , to your computer along with the XML file you've just edited.
+#* Upload both files to a schema validator service such as http://tools.decisionsoft.com/schemaValidate/  (as of April 2023 the xsd gave an error, but journal xml seemed fine and did load to doaj)
+# Go to the URL listed in the article tracking spreadsheet (administrivia tab) and upload the fruits of your labors.
-) Enter keywords if there are any. If not, leave this blank
+Note: if there are any sub-elements in the XML fields (e.g., HTML tags), the document will not validate.  Also of note, Windows often creates character encoding that breaks with UTF-8, throwing an error on validation.
+More info about the feed and how to customize the XML for import into DOAJ:
+* http://journal.code4lib.org/doaj/ and
+* http://www.doaj.org/doaj?func=loadTempl&templ=uploadInfo
+--[[User:Ericleasemorgan|Eric Lease Morgan]] 10:42, 28 May 2008 (PDT)
+[[Category: Code4Lib Journal]]