|
| 1 | +# Cactool FAQ |
| 2 | + |
| 3 | +#About Cactool |
| 4 | + |
| 5 | +## Who created Cactool? |
| 6 | + |
| 7 | +Cactool was created by the principle investigator Dr Liam McLoughlin, with development undertaken by Sam Ezeh. |
| 8 | + |
| 9 | +### Dr Liam McLoughlin |
| 10 | +*Lecturer in Media & Communication at the University of Liverpool* |
| 11 | +Website: [https://leelum.com](https://leelum.com) |
| 12 | +Twitter: [https://twitter.com/leelum](https://twitter.com/leelum) |
| 13 | +Email: liam.mcloughlin [] Liverpool.ac.uk |
| 14 | + |
| 15 | +### Sam Ezeh |
| 16 | +Github: [https://github.com/dignissimus](https://github.com/dignissimus) |
| 17 | +Twitter: [https://twitter.com/dignissimus](https://twitter.com/dignissimus) |
| 18 | +Email: sam.z.ezeh [] gmail.com |
| 19 | + |
| 20 | +The development of Cactool was funded by the University of Liverpool’s Research Development and Initiative Fund (RDIF). |
| 21 | + |
| 22 | + |
| 23 | +## How do I cite Cactool? |
| 24 | + |
| 25 | +If you have found Gephi helpful in your research, please consider citing us. |
| 26 | + |
| 27 | +### Bibtex |
| 28 | +```bibtex |
| 29 | +@software{McLoughlin_Ezeh_2022, |
| 30 | + title = {{Cactool: An easy way to collaboratively code social media posts for manual content and discourse analysis (BETA)}}, |
| 31 | + author = {McLoughlin, Liam and Ezeh, Sam}, |
| 32 | + year = {2022}, |
| 33 | + doi = {10.5281/zenodo.6070206}, |
| 34 | + url = {https://github.com/cactool/cactool}, |
| 35 | + license = {MIT} |
| 36 | +} |
| 37 | +``` |
| 38 | +### APA |
| 39 | +``` |
| 40 | +McLoughlin, L., & Ezeh, S. (2022). Cactool: An easy way to collaboratively code social media posts for manual content and discourse analysis (BETA). [Computer software]. URL:https://github.com/cactool/cactool |
| 41 | +``` |
| 42 | + |
| 43 | + |
| 44 | + |
| 45 | + |
| 46 | +## This install process seems a little complicated, why? |
| 47 | + |
| 48 | +The installation pathway, admittedly, is a little complex (which is why we’ve produced detailed guides). However, this is a necessity to give users a large degree of configurability and allows you to share your instance with others. |
| 49 | + |
| 50 | +## What licence does Cactool run under? |
| 51 | + |
| 52 | +[Cactool runs under the MIT License](https://github.com/cactool/cactool/blob/main/LICENSE). This is a short and simple permissive license with conditions only requiring preservation of copyright and license notices. Licensed works, modifications, and larger works may be distributed under different terms and without source code. |
| 53 | + |
| 54 | +In short, this means it’s free, and you can use it how you like with few limitations. But is provided “As is”, so you can’t sue or take legal action against us for any reason. |
| 55 | + |
| 56 | + |
| 57 | + |
| 58 | +# Troubleshooting |
| 59 | + |
| 60 | +## I’ve spotted a bug or an issue |
| 61 | +If you find any problems with Cactool, please report the issue via the issue tracker here: https://github.com/cactool/cactool/issues or email the PI at Liam.McLoughlin [] Liverpool.ac.uk |
| 62 | + |
| 63 | +If possible, please let us know what circumstances led to the bug. |
| 64 | + |
| 65 | +*Please note, we can’t provide individual support with your project or set up. |
| 66 | + |
| 67 | + |
| 68 | +## I get a “The Connection was Reset” message when attempting to upload a file. |
| 69 | +This might mean the file you’re uploading is larger than the upload file size limit. Increase the file size limit and try again. |
| 70 | + |
| 71 | + |
| 72 | +## I get a 404 Error when uploading a file. |
| 73 | +Make sure you have avoided any unnecessary special characters in the dataset headers (such as * & ^ % ?). We’re looking into fixing this. |
| 74 | + |
| 75 | + |
| 76 | +## I’ve updated to a new version of Cactool, but nothing has changed? |
| 77 | +If you’re using Docker, you will need to delete the Cactool Container & Image within Docker (*WARNING this will delete any research data!*) |
| 78 | + |
| 79 | +<picture><img width="600" alt="image" src="https://github.com/cactool/cactool.github.io/assets/11173283/b994ec43-f26d-4aa4-858e-daba4ace41e2"></picture> |
| 80 | + |
| 81 | + |
| 82 | +## Do you offer Paid Support? |
| 83 | +If, for whatever reason, you feel the need to bring in external assistance in setting up and hosting Cactool, Sam Ezeh can offer reasonable pricing structures for set-up assistance. Please contact them for this. |
| 84 | + |
| 85 | +## Is Cactool available in any other languages? |
| 86 | +Sadly not. Although if you’d like to work with us for translating Cactool, please get in touch! |
| 87 | + |
0 commit comments