Tools guide

The ENP-China project mobilizes a number of tools for the implementation of research. Some represent off-the-shelf tools for collaborative team work. Others serve in actual research work.

Collaborative Work

Calendar

The calendar of project activities has been created under Google calendar. Each member has received an individual invitation and can consult and edit the calendar from a Gmail account. This is extremely useful to keep abreast of activities and inform each other of our movements, activities, proposed meetings, conferences, etc. It can only be consulted with a gmail account.

Slack

We have adopted Slack as our internal platform for communication within the team. It is preferred to email because communications here are project-related. We have opened various dedicated channels, mostly to target different groups within the team. Anyone is free to follow any channel. The “General” channel is used only for information that needs to be sent to everyone. it is more appropriate most of the time to use a dedicated channel to reach fellow members. The current channels are: historians, meeetings, mdrgroup, aixlab, nlp, weekly-reports, sinohistocartograph, storyboard-tableau, 臭豆腐).

Dropbox

The ENP-China folder on Dropbox is to be used for “exchange on the fly”, when members need to make a document available to other members of the team. Periodic deletion will be made so as to leave space available for the continuing exchange of documents. Once an operation is over, the initiator of the document shall simply delete the document. For this reason, all documents that need secure safeguarding shall be saved systematically on Sharedocs.

Sharedocs

This repository is provided by the Huma-Num infrastructure (CNRS). The 1-ERC-ENP-China folder serves as the permanent repository of the documents the members of the team share in the course of research, in particular source documents, work documents, readings, etc.The same document can be saved under successive versions without changing its name. Sharedocs provides a versioning service to retrieve any previous version. File names shall be changed only when the author consider a major change of content has occurred.

This is the current hierarchy of folders and sub-folders which we can change over time and according to your proposals. When one clicks on a folder, a “comment” appears on the right-hand side menu that explains the purpose of the folder. Comment can be added to folders and files. We’ll make use of this functionality in due to work on individual files. The basic functions are simple: drag and drop files or folders onto an existing folder to upload files/folders; right click on a folder or file to download it. We shall use Sharedocs to store documents, mostly papers, books, sources, etc. to be processed with the various digital tools.
 
Sharedocs: structure of the Source Books folder
 
Source books (directories, who’s whos, diaries, etc.) shall be uploaded to the Source Books folder (pdf, jpeg, tiff). This folder comprises the following subfolders:
 
Please use only the “1-Identified” folder. This will remain the basic repository folder where you can always find the uploaded files. As we process them, individual files will go down the line (verified, selected, processed, etc.) until they have been turned into data. Yet, we will process duplicates so as tio maintain the integrity of the original “Identified” folder.
 
Important rule: when you upload a file, make sure that you also create a record in Zotero (also in the “Source Books” folder) and to copy the Sharedocs URL of the uploaded document in the URL field in the Zotero record.

ENP-freizo

We are developing a digital library on the Freizo infrastructure to provide access to high-resolution images of source documents (iiif standard), but also to process these documents through annotation, data extraction, and building new sub-sets of textual or visual data. This iiif service operates under Huma-Num within a larger consortium that relies on CERN’s Invenio 3 and a federated network of long-term Hasdai repositories.

Zotero

All the bibliographic references of the project are managed and stored through the Zotero ENP-China library, including  source materials, readings, team publications, etc. Any document placed on Sharedocs shall be recorded on Zotero in one of the pre-defined folders (again this may evolve of course).

Keyword tagging in Zotero: to enable or facilitate the identification of readings and publications by genre, producer, etc., we suggest the following basic keywords in the “Tag” tab. Various keywords can apply to the same reference. Feel free to add more keywords to the present list.

  • PDF: for all documents that are stored in Sharedocs (add the Sharedocs URL n the URL field of the Zotero record to facilitate direct access)
  • DSci: for all readings or publications related to Data Science
  • ELT: for all readings or publicationsrelated to Elites
  • ELTCN: for all readings or publications related to Elites in China (including greater China)
  • GIS: for all readings or publications related to Geographical Information Systems
  • HST: for all readings or publications related to history in general
  • Methods: for all readings or publications with a focus on methods, including readings in history, humanities, etc.
  • ML: for all readings or publications related to Machine Learning
  • NLP : for all readings or publications related to Natural Language Processing
  • SNA: for all readings or publications related to Social Network Analysis or Network Analysis
  • Team: for all the publications by a member of the team
  • ZHG: for all readings or publications related to China

Dropbox

The Dropbox account and folders  serve for day-to-day “on the fly” communication and exchange. The documents pertaining to regular  ERC project management (original application,  communication, etc.) are also stored here for your convenience. Yet, as a rule this will not be used for storage. It is a temporary place of abode as we work on some files, for example, or write a document collaboratively, etc. But all work file shall be saved on Sharedocs at the end of the day.
 
Overleaf

Research tools

X-Mind
Evernote
 
Brat/Folia
 
R-studio
ENP GitLab