...
Once the application is installed, navigate to File → Import and upload the dart_-publications.json file that is attached to this DIME article.
...
Download the attached python script, json_to_markdownpublications.py, and place it in the same directory as the the dart-publications.json file. The python script will read and format the publications contained in the json file to build the content of the publications page. Open a terminal window, change to the directory that contains the python script and the json file and run the python script:
python json_to_markdownpublications.py
It will output a file named _index.md that should be moved to dart-web/content/publications/_index.md.
...
| View file | ||||
|---|---|---|---|---|
|
| View file | ||||
|---|---|---|---|---|
|
Updating the dissertations and theses page
The process for updating the dissertations and theses page is similar except that Zotero is not as adept at automatically parsing the webpage for a given university's database of dissertations and theses, so the record created in Zotero may have to be edited manually to ensure all of the metadata was uploaded properly. An example dart-dissertations-and-theses.json file is attached below, and the script needed to create the dissertations-and-theses page is also attached below.
1. Using citation management software to curate a list of dissertations and theses that use DART
If you don't have Zotero installed, follow the installation instructions in the previous section, "Updating the publications page." Once the application is installed, navigate to File → Import and upload the dart-dissertations-theses.json file that is attached to this DIME article.
To add a new dissertation or thesis to this collection, navigate to the webpage containing the dissertation or thesis in a given university's database of such documents. A given university's database of dissertations and theses is less readily indexed by Google Scholar, so it is often more difficult to find dissertations and theses that use DART. Oftentimes, the DART team must be made aware of the existence of a dissertation or thesis by the student once they have completed their degree.
A citation for a dissertation or thesis can be added to the DART dissertations-theses collection by navigating to the landing page of the desired publication and clicking on the "Save to Zotero" icon that appears in the top-right corner of the browser window:
The new publication will be added to your local Zotero database. Note that the publication will be added to whichever collection is open in the navigation panel to the left of the desktop application, so you should have the dart-dissertations-theses collection open:
When you are finished adding new dissertations and theses, export the collection by right clicking on the collection name and selecting "Export Collection...".
Save the collection in CSL JSON file format:
2. Running a python script to format a data file output by the citation management software
Download the attached python script, dissertations-and-theses.py, and place it in the same directory as the the dart-dissertations-theses.json file. The python script will read and format the dissertations and theses contained in the json file to build the content of the dissertations-and-theses page. Open a terminal window, change to the directory that contains the python script and the json file and run the python script:
python dissertations-and-theses.py
It will output a file named _index.md that should be moved to dart-web/content/dissertations-and-theses/_index.md.
| View file | ||||
|---|---|---|---|---|
|
| View file | ||||
|---|---|---|---|---|
|
3. Committing the resulting file to the dart-web repository and pushing it to https://github.com/NCAR/dart-web
Once the newly created _index.md file has been moved to the the dart-web/content/dissertations-and-theses/ directory, commit the changes and push them to the dart-web repository on Github.
DART documentation
The DART documentation is hosted at readthedocs:
...