SamsonLai: Difference between revisions

no edit summary
No edit summary
No edit summary
Line 25: Line 25:
|-
|-
|Update the Main Page for BatteryKB.
|Update the Main Page for BatteryKB.
|Add all members of SALAMANDER as Organizational Units
|
|Create a manual of style for BatteryKB.
|Create a manual of style for BatteryKB.
|Make the info box narrower, hide the "machine-readable" relevant content inside the wiki text as comments
|Make the info box narrower, hide the "machine-readable" relevant content inside the wiki text as comments
Line 40: Line 40:
|-
|-
|Fix why [[ isn't easily finding SALAMANDER project page
|Fix why [[ isn't easily finding SALAMANDER project page
|
|How to edit the json file directly to fix a mistake (need to include a comment on why the change was made and update erforderlich to English)
|
|-
|Ask if I can get admin rights to the wiki or moderator/editor level privileges
|
|
|
|-
|Change the user name used in logs from the ORCID number to something customized
|
|
|
|-
|How to prevent the creation of duplicate entities
[[Item:OSWf3f7a0feca884b87a5a925278d26a637]] (dupe)
[[Item:OSW02ab1b78340040efaf16d2700b6f3aaf]] (real)
|
|
|
|-
|
|
|
|
|
Line 57: Line 79:
# Note: if you make a mistake,    you can undo the move. Either move the page back or go the history of the    page and click Revert.  
# Note: if you make a mistake,    you can undo the move. Either move the page back or go the history of the    page and click Revert.  
# Note: if you edit the user page, you will get a warning about editing a page for an account that doesn't exist.
# Note: if you edit the user page, you will get a warning about editing a page for an account that doesn't exist.
# Note: unfortunately, this doesn't fix the user name used in the recent changes and contributions log.


==== How to make yourself a User entity in the Battery KB (not the same as above): ====
==== How to make yourself a User entity in the Battery KB (not the same as above): ====
Line 74: Line 97:
# Click the + sign to add a new node.
# Click the + sign to add a new node.
# Type in your name in the search box and click on the right entry from the search suggestions.  
# Type in your name in the search box and click on the right entry from the search suggestions.  
## Troubleshooting: if you can't find your name, that means you didn't create yourself as a User entity first. You need to do that before adding yourself to a project. No, you cannot simply type in your name for now.  
## Troubleshooting: if you can't find your name, that means you didn't create yourself as a User entity first. You need to do that before adding yourself to a project. No, you cannot simply type in your name for now (you will learn how to do this later).
# Click Save.
# Click Save.
# Finished! Note: it may take some time for the changes are reflected on the page. You can try refreshing and purging the cache by using Shift+F5.
# Finished! Note: it may take some time for the changes are reflected on the page. You can try refreshing and purging the cache by using Shift+F5.
# Next steps: notice anything that you couldn't add to your User entity parameters because the objects didn't already exist? Go to those Categories and start creating those entities. For example, you can check for whether the BatteryKB already has your institution as an Organization entity here:[[:Category:OSW1969007d5acf40539642877659a02c23]]
# Next steps: notice anything that you couldn't add to your User entity parameters because the objects didn't already exist? Go to those Categories and start creating those entities. For example, you can check for whether the BatteryKB already has your institution as an Organization entity here:[[:Category:OSW1969007d5acf40539642877659a02c23]]
# Next steps: improve the quality of your User entity. Here is an example a good quality User entity: [[Item:OSW72e733f317ef4cf9b8ca53e906c9acb9|Simon Clark]].
# Next steps: improve the quality of your User entity. Here is an example a good quality User entity: [[Item:OSW72e733f317ef4cf9b8ca53e906c9acb9|Simon Clark]].
# Troubleshooting: Member vs. Member Of?
## '''Member''': if you want to associate yourself or your institutional affiliation with a Project, note that you go to the Project and Edit data there, '''not''' Edit data on your entity.
## '''Member Of''': if you want to associate yourself to your institutional affiliation, you edit your entity page. If your organization belongs to a larger organizational unit, then you edit your organization's entity page. If you put the organization as a '''Member Of''' the project (this shouldn't be allowed anyway, but you may be confused as to why), it means your project would own your organization (which probably isn't true).
## In summary, Projects add members to ''their'' data, but Users add affiliation to ''their'' data.
==== How to add a new entity on the fly: ====
So you've created an entity or two under the pre-existing Categories. Great. But maybe you had some trouble putting in entities that don't exist yet because this wiki is in its early stages of creation. Let's say you want to add your organization and you found it doesn't exist in [[:Category:OSW1969007d5acf40539642877659a02c23]] yet.
# First go to the Category and click + Create at the top.
# Fill in the usual information. Note that acronyms go under the field Short Name(s). But this parameter field doesn't show up by default.
## Click at the top with "three bars select properties"
## Find the "Short name(s)" field and click the checkbox. Click outside of the small menu to close it.
## A new field box named "Short name(s):" is now in the Data-Editor window.
## Click on the + to create an entry in this parameter and type in the acronym/short name of the organization.
# Let's say you want to type in the country of your organization in the Country field, but the country doesn't exist as an entity in BatteryKB yet.
## The system won't let you type a country name that isn't an existing country entity. Remember: ''nothing'' exists outside of the ontological framework.
## But now that you know how to create an entity, you could go the Category for the Country and click + Create on it. However, there's a faster method.
## Next to the field, click on the blue icon
## This will automatically take you a new Data-Editor pop-up box as if you hit + Create for that Category. You can now type in the name of the country in the Text parameter field. ''Tip'': If you're ever confused about which Data-Editor box you're in, just look at the top of the box.
## Click Save at the top right, which will create the new Entity and bring you back to the first Data-Editor pop-up box.
## Now type in the Country field the name of the Country Entity you just created. It may take a moment to show up. Try typing slowly.
# Click Save in the top right of the Data-editor window.
# Finished!


==== How to make a link: ====
==== How to make a link: ====
Line 92: Line 138:
==== How to help: ====
==== How to help: ====


# If you've never edited    Wikipedia before or worked on any other kind of wiki, reading the    introduction and basic five pillars of this page are extremely helpful to    understanding what a successful wiki culture requires: <nowiki>https://en.wikipedia.org/wiki/Wikipedia:A_primer_for_newcomers</nowiki>.  
# If you've never edited    Wikipedia before or worked on any other kind of wiki, reading the    introduction and basic five pillars of this page are extremely helpful to    understanding what a successful wiki culture requires: {{Template:Viewer/Link|page=|url=https://en.wikipedia.org/wiki/Wikipedia:A_primer_for_newcomers|label=https://en.wikipedia.org/wiki/Wikipedia:A_primer_for_newcomers}}.  
# In essence, Wikipedia has    already developed processes and procedures that solve a lot of common    problems and the BatteryKB doesn't need to reinvent the wheel (at least,    completely).
# In essence, Wikipedia has    already developed processes and procedures that solve a lot of common    problems and the BatteryKB doesn't need to reinvent the wheel (at least,    completely).
# One of the best aspects about wikis in general is that you can learn nearly everything by simply copying what you see in a good page. However, this is more difficult in the BatteryKB due to how its ontological structuring.
# One of the best aspects about wikis in general is that you can learn nearly everything by simply copying what you see in a good page. However, this is more difficult in the BatteryKB due to how its ontological structuring.