{"id":21206619,"url":"https://github.com/oncomouse/teachdh-test","last_synced_at":"2026-03-19T19:18:45.788Z","repository":{"id":40766930,"uuid":"267328192","full_name":"oncomouse/teachdh-test","owner":"oncomouse","description":null,"archived":false,"fork":false,"pushed_at":"2023-01-06T11:36:03.000Z","size":1774,"stargazers_count":0,"open_issues_count":6,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-21T15:48:39.403Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oncomouse.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-05-27T13:34:39.000Z","updated_at":"2022-10-08T22:27:03.000Z","dependencies_parsed_at":"2023-02-06T00:15:50.793Z","dependency_job_id":null,"html_url":"https://github.com/oncomouse/teachdh-test","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oncomouse%2Fteachdh-test","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oncomouse%2Fteachdh-test/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oncomouse%2Fteachdh-test/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oncomouse%2Fteachdh-test/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oncomouse","download_url":"https://codeload.github.com/oncomouse/teachdh-test/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243658270,"owners_count":20326467,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T20:56:14.744Z","updated_at":"2026-01-02T06:32:43.603Z","avatar_url":"https://github.com/oncomouse.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TeachDH Test Site\n\nTo build a live searchable FAQ as a companion to the second edition of [*Using Digital Humanities in the Classroom*](https://www.bloomsbury.com/uk/using-digital-humanities-in-the-classroom-9781350029750/), [Jekyll](https://github.com/jekyll/jekyll) was used.\n\n## Getting Started\n\nTo develop this site, you will need Ruby and Bundler installed. Install ruby for your system, as you see fit. Note macOS ships with an out-dated version of Ruby, so you will need to use something like [Homebrew](https://brew.sh/) to install it. Run `brew install ruby` after installing Homebrew.\n\nWith Ruby installed, run `gem install bundler` to install the software we need to build the site.\n\nOnce Ruby and Bundler are working, run `bundle install` in the directory you cloned from GitHub and you should have a working copy of the site.\n\n## Updating the Site Layout\n\nThe main styles for the page are located in `assets/css/site.scss`. This is [Sass](https://sass-lang.com/) file and will update page styles.\n\nThe layout for the site is located in `_layouts/teachdh.html`. The `{{ content }}` tag will be replaced with the questions. Jekyll will process [Liquid](https://jekyllrb.com/docs/liquid/) tags in this file.\n\nThe site is currently configured to use [Tachyons](http://tachyons.io/) for CSS. It is a functional CSS framework that is very simple to work with.\n\n## Adding Questions\n\nWe use Jekyll's [blogging features](https://jekyllrb.com/docs/posts/) to handle questions. To create a post, add a new Markdown file (`.md` extension) or HTML file (`.html` extension) to the `_posts/` directory. The file must be named in the following form:\n\n~~~\nYEAR-MONTH-DAY-TITLE.MARKUP\n~~~\n\nThe dates don't matter for the purposes of this site, but earlier dates will display before later dates, so you can use the date of the post to sort questions on the main page. `TITLE` can be anything in this context. It's easier to set the title in YAML front matter of the post (see an example below).\n\nHere's a sample Markdown question file:\n\n~~~markdown\n---\ntitle: \"Is This a Question?\"\ncategories:\n  - Chapter 1\n  - FAQ\n---\nThis is the answer to the above question.\n\nIt is a question!\n~~~\nIn the above example, two categories are defined: `FAQ` and `Chapter 1`. The site will generate the overall list of categories based on each question's, so you may add as many categories as you wish.\n\n`categories`, above, is an example of a [YAML sequence](https://www.tutorialspoint.com/yaml/yaml_sequence_styles.htm). Each entry in the sequence is on a new line, indented and prepended with a `-`.\n\n\n## Testing the Site\n\nRun `bundle exec jekyll serve` to start a development server. It will run on [http://localhost:4000](http://localhost:4000).\n\n## Building the Site\n\n### Basic Mode\n\nTo build the site, run `bundle exec jekyll build` and upload the contents of the `_site` directory to your desired static host.\n\nOr, push to a GitHub repository and [the repository's publishing source must be set to `master`](https://help.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source).\n\n### Advanced Mode\n\nIf you would like to compress assets and HTML files and generally build a smaller, more performant version of the site, you have to have [Node.js](https://nodejs.org/en/) installed.\n\nWhen you do, run `npm install` in the directory to install the required libraries.\n\nThen, instead of running `bundle exec jekyll build` as above, run `bundle exec rake build` to build the site and upload the contents of `_site` to your desired static host.\n\nThe Rake file will also deploy to the `gh-pages` branch for GitHub Pages using `bundle exec rake deploy`.\n\nFor deployment to GitHub Pages to work, [the repository's publishing source must be set to `gh-pages`](https://help.github.com/en/github/working-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site#choosing-a-publishing-source).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foncomouse%2Fteachdh-test","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foncomouse%2Fteachdh-test","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foncomouse%2Fteachdh-test/lists"}