Skip to content

Docs photo essay #517

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 26 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
26 commits
Select commit Hold shift + click to select a range
d80a7af
new artifact tutorial screenshot 1
TanishaChetty Oct 26, 2024
a3dda25
new artifact screenshot 2
TanishaChetty Oct 26, 2024
a783dde
new artifact tutorial 3
TanishaChetty Oct 27, 2024
3ac13d0
new artifact tutorial 4
TanishaChetty Oct 27, 2024
ef35c0f
new artifact tutorial 5
TanishaChetty Oct 27, 2024
92be0d7
new artifact tutorial 6
TanishaChetty Oct 27, 2024
e9d8f80
new artifact tutorial 7
TanishaChetty Oct 27, 2024
54d307a
new artifact tutorial 8
TanishaChetty Oct 27, 2024
7e4b457
photo essay
TanishaChetty Oct 30, 2024
050b765
Create photo-essay-new.md
TanishaChetty Oct 30, 2024
b6bcab7
commit attempt...
TanishaChetty Oct 30, 2024
72c701f
first edit
TanishaChetty Nov 23, 2024
1b316a5
first draft with no pics
TanishaChetty Nov 23, 2024
375f2ac
more edits
TanishaChetty Nov 23, 2024
eca4764
photo essay 1
TanishaChetty Nov 23, 2024
7e5778f
new photo essay 1
TanishaChetty Nov 23, 2024
17dcfd9
first pic added
TanishaChetty Nov 23, 2024
036db0e
Merge branch 'docs-photo-essay' of https://github.com/PECE-project/dr…
TanishaChetty Nov 23, 2024
b3b50f3
new photo essay 2
TanishaChetty Nov 23, 2024
3b36c33
pic 2
TanishaChetty Nov 23, 2024
a92bd61
Merge branch 'docs-photo-essay' of https://github.com/PECE-project/dr…
TanishaChetty Nov 23, 2024
2023cea
click photo essay
TanishaChetty Nov 23, 2024
dc804eb
title image
TanishaChetty Nov 23, 2024
1a34d7d
adding artifact
TanishaChetty Nov 23, 2024
29905d3
add caption
TanishaChetty Nov 23, 2024
dc1b283
finished with pictures
TanishaChetty Nov 23, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions photo-essay-new
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@

Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added src/docs/source/docs/media/new-photo-essay-3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
63 changes: 63 additions & 0 deletions src/docs/source/docs/photo-essay-new.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@

Steps to Create a Photo Essay

1. The process of adding any variety of content to PECE begins by logging in with your screen name and password and clicking “Create Content” in the top right corner.

![](media/PECE-new-artifact-create-content-screenshot.png)

You should now see the "Add content" page.

![](media/PECE-new-artifact-add-content-screenshot.png)

On this page you will find a grid of options for creating different forms of new content followed by their brief descriptions. "Photo Essay" is one type of content, located in the "Curate" section. A photo essay is a collection of image artifacts, ordered into a slideshow, with text added for context.


2. Click “Photo Essay”

![](media/new-photo-essay-3.png)

You should now have access to all of the fields you need to fill out in order to create a new Photo Essay.

3. First, type the title in the “Title” pane.
Next, write out your project description in the “Description” section.

![](media/new-photo-essay-title.png)

4. You are now ready to upload your image artifacts into your Photo Essay.
In the "Items" section, begin by typing the title of the image artifact into the “Image Artifact” pane. Your Image Artifact should pop up as an option to select.

![](media/new-photo-essay-artifact.png)

Click on the title of your Image Artifact to select it.
Next, type in the “Substantive Caption” into the “Text” pane.

![](media/new-photo-essay-desc.png)

5. Once this artifact is added, click “Add Photo essay item.” Repeat Step 4 for your remaining Image Artifacts.


6. Next, scroll down to the metadata fields. The menu bar on the left side will automatically be open to the "Permission, Authorship, and Groups" section. Your screen name should already appear in the first contributor field. Listed contributors have the ability to edit the content, and are also credited as content contributors when the content is published. To add the names of any other project members who you would like to grant access to editing the artifact, type the first few letters of their name into the other “contributor” field. To add more than one additional contributor, click the "add another item" button and enter their name in the new field.

7. Next, scroll down to the "View Permission and Groups" section. The button switch will automatically set viewing permissions to "Everyone can view this content," making the artifact visible to all internet users. If you want to restrict access to the content, click the button switch to turn this off. If you choose to leave the toggle on, you can still associate the content with a particular group. To do so, complete the "Group association and view access." You can select a group with which to associate the content by typing its name into the field. If you choose to restrict access to the content, you can designate specific people or groups that will have view access. To allow specific people viewing access, in the field, "People with view access" type the first few letters of their name and select their username. Add groups whose members should have view access to this memo by typing the group name into the "Group association and view access" field. Note that if you give a group view access, it will also associate the content with that group. This means the content will appear on the group's page.

![](media/new-photo-essay-permissions.png)


8. Next, fill out the "Contribution Metadada" section, making sure to select the correct license and add any critical commentary. For the license, we encourage you to leave it as Attribution, Share Alike CC BY-SA, but you can choose any of the other Creative Commons license as you see fit. Descriptions of available creative commons licenses can be found here.

Tag the content. As you type, suggested tags will be automatically generated if they exist already in the system. We recommend following theses suggestions and using existing tags if they are not too different from what you were intending, but feel free to make up new tags!

![](media/new-photo-essay-contribution.png)

9. Next, fill out the "Custom Citation" section, using your platform's preferred citation format.


10. Next Choose a “thumbnail” image to represent your essay.

You can edit this image later.
Click "Add media" to upload the image. Type in Alt Text and/or Title Text as desired (you can simply leave these blank), and click "Save and Insert" tp upload.

![](media/new-photo-essay-citation.png)

Click save at the top to save your work.
Congratulations! You’ve created your Photo Essay!
Loading