Skip to content
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

Twarc Tutorial #558

Merged
merged 22 commits into from
Dec 20, 2022
Merged
Show file tree
Hide file tree
Changes from 21 commits
Commits
Show all changes
22 commits
Select commit Hold shift + click to select a range
029f89c
Rework documentation and structure a bit to include a new tutorial se…
SamHames Oct 20, 2021
ecf47cd
Propose a skeleton structure for the tutorial
SamHames Oct 20, 2021
2200954
Cleanup the tutorial a little
SamHames Nov 29, 2021
83f62b3
First draft of the 'before we begin' section
SamHames Jan 17, 2022
2c37abb
More cleanup and moar words for the tutorial
SamHames Jan 24, 2022
2a9ae9b
Flesh out more of the actual search content
SamHames Feb 3, 2022
a617115
Update the data processing to avoid working with excel at all
SamHames Feb 8, 2022
65c5a6a
Incorporate more of the counts/search workflow as an interative approach
SamHames Feb 8, 2022
28cf9d6
Flesh out the search/counts worked example, cleanup some todos
SamHames Feb 9, 2022
17ae42d
Rearrange sections based on the suggestion [ci skip]
SamHames Feb 11, 2022
d0aaa0d
Make the research question more concrete
SamHames Feb 11, 2022
870f3f3
Link to existing resources section of the twarc docs [ci skip]
SamHames Feb 11, 2022
b566fc6
Add module installation to documentation local development instructions
betsybookwyrm May 23, 2022
0a4a0d9
Tutorial: Fill out API explainer section
betsybookwyrm May 23, 2022
ec3a257
Flesh out Intro to Twitter API tutorial section
betsybookwyrm Jul 15, 2022
cce8488
Minor proofreading fixes for tutorial
betsybookwyrm Oct 10, 2022
7cf5943
Require mkdocstrings[python] for docs building
betsybookwyrm Oct 10, 2022
52289d2
Explain API versions
betsybookwyrm Oct 10, 2022
e360879
Merge branch 'tutorial' of github.com:boyd-nguyen/twarc into tutorial
boyd-nguyen Nov 11, 2022
11f4dc8
added screenshots + editted code blocks + fixed minor typos
boyd-nguyen Nov 11, 2022
2432ec3
Merge pull request #665 from boyd-nguyen/tutorial
SamHames Nov 11, 2022
ece130f
Apply suggestions from code review
igorbrigadir Dec 15, 2022
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 README.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ The documentation is managed at ReadTheDocs. If you would like to improve the do
To view your documentation locally you should be able to:

pip install -r requirements-mkdocs.txt
pip install -e .
mkdocs serve
open http://127.0.0.1:8000/

Expand Down
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,4 +26,4 @@ For `R` there is [academictwitteR](https://cran.r-project.org/web/packages/acade

## Getting Help

Check the [tutorials](tutorials.md) to get started, or follow along with this [recorded stream](https://tube.nocturlab.fr/videos/watch/1d98d20e-a4fd-4594-aa94-9b1b1301cead) introducing twarc. If you run into trouble, feel free to make a post on the [Twarc Repository](https://github.com/DocNow/twarc/issues) or on the [Twitter Developer Forums](https://twittercommunity.com/c/academic-research/62).
Check out the [tutorial](tutorial.md) to get started, or follow along with this [recorded stream](https://tube.nocturlab.fr/videos/watch/1d98d20e-a4fd-4594-aa94-9b1b1301cead) introducing twarc. You can also find additional resources linked from [resources](resources.md). If you run into trouble, feel free to make a post on the [Twarc Repository](https://github.com/DocNow/twarc/issues) or on the [Twitter Developer Forums](https://twittercommunity.com/c/academic-research/62).
Binary file added docs/images/CMD.png
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 docs/images/echidna_csv.png
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 docs/images/excel_echidna.png
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 docs/images/json_echidna.png
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 docs/images/pip_install.png
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 docs/images/twarc_configure.png
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 docs/images/twarc_count_echidna.png
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 docs/images/twarc_help.png
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 docs/images/twarc_progress_download.png
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 docs/images/win_installer.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions docs/tutorials.md → docs/resources.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Twarc Tutorials
# Twarc Tutorials and Other Resources

Documentation here is largely auto generated from the code, which may not always be the most user friendly. Others have written great totorials on using twarc, and these are linked here.
Documentation here is largely auto generated from the code, which may not always be the most user friendly. Others have written great tutorials and other resources relating to using twarc, or working with the data generated by twarc. If you'd like to suggest additional resources that are relevant, please feel to open a pull request or open an issue.

## UVA Library's Scholars' Lab Twarc Tutorial

Expand Down
436 changes: 436 additions & 0 deletions docs/tutorial.md

Large diffs are not rendered by default.

3 changes: 2 additions & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,8 @@ nav:
- twarc1 (sw): twarc1_sw_ke.md
- twarc1 (zw): twarc1_zw_zh.md
- Plugins: plugins.md
- Tutorials: tutorials.md
- Tutorial: tutorial.md
- Resources: resources.md
- Twitter Developer Access: twitter-developer-access.md
- Windows 10: windows10.md
- Library API:
Expand Down
2 changes: 1 addition & 1 deletion requirements-mkdocs.txt
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ tqdm>=4.62
mkdocs>=1.2
mkdocs-click>=0.4
mkdocs-material>=7.2
mkdocstrings>=0.15
mkdocstrings[python]>=0.15