{"id":28028936,"url":"https://github.com/mit-ccc/social-machines.github.io","last_synced_at":"2025-07-31T08:37:23.618Z","repository":{"id":25310010,"uuid":"100064869","full_name":"mit-ccc/social-machines.github.io","owner":"mit-ccc","description":"LSM Jekyll Site","archived":false,"fork":false,"pushed_at":"2023-04-11T23:05:37.000Z","size":119678,"stargazers_count":3,"open_issues_count":7,"forks_count":3,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-01-17T01:16:18.105Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://socialmachines.org","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mit-ccc.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-08-11T19:39:28.000Z","updated_at":"2024-01-17T01:16:18.106Z","dependencies_parsed_at":"2022-08-09T08:46:52.507Z","dependency_job_id":null,"html_url":"https://github.com/mit-ccc/social-machines.github.io","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/mit-ccc%2Fsocial-machines.github.io","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mit-ccc%2Fsocial-machines.github.io/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mit-ccc%2Fsocial-machines.github.io/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mit-ccc%2Fsocial-machines.github.io/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mit-ccc","download_url":"https://codeload.github.com/mit-ccc/social-machines.github.io/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253534425,"owners_count":21923521,"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":"2025-05-11T07:35:06.704Z","updated_at":"2025-05-11T07:35:07.575Z","avatar_url":"https://github.com/mit-ccc.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lab for Social Machines Jekyll Web Site\n\nView the live site: https://social-machines.github.io/\n\n---\n\n# Getting Started\n\nThis website is created using [Jekyll](https://jekyllrb.com/), a static site generator. The general flow of editing the site is:\n\n1. Clone the repository locally:\n```\ngit clone git@github.com:social-machines/social-machines.github.io.git\n```\n2. Start a Jekyll server in the cloned directory:\n```\nbundle exec jekyll serve\n```\nThis will allow you to see your local changes at http://localhost:4000 before you push them live. Every time you save a file, just refresh the page and Jekyll will have regenerated the site with the new changes.\n\n3. Edit files locally as per the instructions below, save, and verify your changes are correct on your locally hosted version of the site.\n4. Commit the changes you've made to the repository.\n5. Push the changes you've made to GitHub. After a minute or two, refresh the live site to see your changes. If you do not see the changes after a few minutes, check [GitHub System Status](https://status.github.com/messages) to see if they are experiencing delays with builds.\n\n**NOTE** Do not edit **any** files in the **_site** directory. These are auto-generated by Jekyll and will be overwritten. Pretend that folder does not exist.\n\n# Editing Instructions\n\nHere are instructions for doing various types of edits to the site.\n\n**NOTE** Do not edit **any** files in the **_site** directory. These are auto-generated by Jekyll and will be overwritten. Pretend that folder does not exist.\n\n## Add a publication\n\n[![Add a publication](https://img.youtube.com/vi/NEDEVrn6MVQ/0.jpg) Watch video explanation](https://www.youtube.com/watch?v=NEDEVrn6MVQ)\n\nAll publication data is stored in **_data/publications.yml** and **_data/theses.yml** if it is a thesis. The contents of that file are used to populate the publications throughout the site, applying different filters based on attributes defined for each publication. For instance, the publications that show up on the [Media Analytics Publications page](https://social-machines.github.io/media-analytics/publications) are filtered to those with `group: media analytics`.\n\n1. Open the file **_data/publications.yml**\n1. Add an entry for the new publication at the top of the file (or ideally in sorted reverse chronological order).\n\nAn entry for a publication looks like the following:\n\n```yaml\n- citation: |\n    Soroush Vosoughi\\*, Prashanth Vijayaraghavan\\*, Ann Yuan, and Deb Roy. (2017). **Mapping Twitter Conversation Landscapes**. In Proceedings of the 11th International AAAI Conference on Weblogs and Social Media (ICWSM 2017). Montreal, Canada. \\*Equal Contribution.\n  publication_year: 2017\n  pdf_file: http://lsm.media.mit.edu/papers/ICWSM-2017.pdf\n  group: media analytics\n  academic: true\n  tags:\n    - Machine Learning\n    - Social Networks\n    - Natural Language Processing\n```\n\nA few things to note:\n\n- The `citation` field is written in Markdown, so asterisks will be interpretted accordingly. For equal contribution, make sure you escape the asterisk with a backslash: **\\\\\\***. Titles should be marked in bold by surrounding them with two asterisks (e.g. \\*\\*My Paper Title\\*\\*).\n- The `pdf_file` field is a URL and should point to http://lsm.media.mit.edu/papers/YOUR_PAPER_PDF.pdf. You'll need to upload your file to the paper hosting server for this URL to work, as described below in the \"Uploading a paper\" section.\n- The `group` field indicates whether it will show up on the Media Analytics publications page (with value `media analytics`) or the Learning page (with value `learning`)\n- The `academic` field indicates whether the paper is academic (e.g. a conference or journal paper) or not (e.g. a blog post, or a news article)\n- The `tags` field contains a list of tags that can be used to filter the paper. Currently the list of tags to choose from is:\n  - Machine Learning\n  - Robotics\n  - Cognitive Science\n  - Learning\n  - Natural Language Processing\n  - Social Networks\n  - Visualization\n\n  If you think there should be a new tag added, discuss with others first.\n\n\n### Uploading a paper\n\nWe have a separate place where we are storing all our papers since they can be quite large especially when videos are embedded in them. The box was setup for us by NECSYS and is available at **lsm.media.mit.edu**. To upload a paper, you'll need to connect to the server over SMB. If you're not on campus, you'll need to be on the Media Lab VPN ([instructions to connect to VPN](http://wiki.media.mit.edu/view/Necsys/HowToVPN)).\n\nThe following instructions explain how to upload a paper to the SMB server on a Mac.\n\nOpen **Finder** and select **Go -\u003e Connect to Server...** from the menu bar (or press Cmd+K)\n\n\u003cimg src=\"https://user-images.githubusercontent.com/793847/37048648-82cfad36-213c-11e8-9e97-293f41dace7a.png\" width=\"700\" /\u003e\n\nEnter **smb://lsm.media.mit.edu** as the Server Address. Optionally click the **+** to save it as a favorite. Click **Connect**.\n\n\u003cimg src=\"https://user-images.githubusercontent.com/793847/37048676-9474aa82-213c-11e8-968a-3b4496937f71.png\" width=\"700\" /\u003e\n\nClick **Connect** when prompted about connecting.\n\n\u003cimg src=\"https://user-images.githubusercontent.com/793847/37049138-f6adba44-213d-11e8-9f17-3c48f32f6d6b.png\" width=\"700\" /\u003e\n\nEnter your Kerberos login information. You do not need to add an email address, just use your username. Then click **Connect** to continue.\n\n\u003cimg src=\"https://user-images.githubusercontent.com/793847/37049153-0236edea-213e-11e8-924e-b35b616b364e.png\" width=\"700\" /\u003e\n\n\nScroll to select **lsm.media.mit.edu** as the volume you'd like to mount (or type \"lsm\" to quickly get to it).\n\n\u003cimg src=\"https://user-images.githubusercontent.com/793847/37048735-c9c82920-213c-11e8-91cb-a046c8ebb327.png\" width=\"700\" /\u003e\n\nThis opens up a finder window to the mounted SMB server. The **papers** directory is where you should put your PDF file.\n\n\u003cimg src=\"https://user-images.githubusercontent.com/793847/37048802-f70257f8-213c-11e8-8150-0bcc74f4adf5.png\" width=\"700\" /\u003e\n\n\u003cimg src=\"https://user-images.githubusercontent.com/793847/37048839-0cd8eef2-213d-11e8-9d74-1931b439a4bf.png\" width=\"700\" /\u003e\n\nThat paper is now available to be read at http://lsm.media.mit.edu/papers/a_paper.pdf. Use that URL as the value for `pdf_file` in your citation entry.\n\n\n## Add a project\n\nProjects are currently very limited in their presentation on the site. They are comprised solely of a title, an image, the group they are under, and a link to the project page on [the Media Lab site](https://www.media.mit.edu/groups/social-machines/projects/). The project data is stored in **_data/projects.yml**.\n\n1. Open the file **_data/projects.yml**\n1. Add the entry for the new project to the top of the file.\n\nAn entry for a project looks like the following:\n\n```yaml\n- title: \"FlipFeed\"\n  image: https://dam-prod.media.mit.edu/thumb/2017/01/18/1_Mk6xr17.jpg.800x800.jpg\n  url: https://www.media.mit.edu/projects/flipfeed/overview/\n  group: media analytics\n```\n\nThe idea is to save students work from reproducing content for projects everywhere, we can just re-use the title and images required for the Media Lab's site.\n\nThings to note\n\n- The `group` field should be one of `media analytics` or `learning`.\n\n## Add a person\n\nThe people data is all stored in **_data/people.yml**.\n\n1. Open the file **_data/people.yml**\n1. Add the entry for the new person to the top of the file.\n\nAn entry for a person looks like the following:\n\n```yaml\n- name: Lisa Conn\n  title: Graduate Researcher\n  type: student\n  image: http://excedrin.media.mit.edu/socialmachines/wp-content/uploads/sites/27/2014/07/IMG_4998-e1454462435442.jpg\n  groups:\n    - media analytics\n    - cortico\n  alumni: true\n```\n\nThings to note\n\n- The `groups` field should contain any of `media analytics`, `learning`, or `cortico`.\n- Set `alumni: true` when a person leaves the lab. It's okay if this field is not there at all (this implies it is false).\n- The `type` field should be one of: leadership, faculty, staff, visitor, postdoc, student, cortico\n- The order in which people show up on the team pages is determined by a variable called `people_order` on the pages themselves. See **learning/people.md** for an example.\n\n\n## Add an image to the Life at the Lab image gallery\n\nSay we want to add the image **tim-cook-deb.jpg** to the image gallery.\n\n1. Add the image file to the **img/** directory.\n1. Edit **life-at-the-lab.md** and add to the `images:` list `- ../img/tim-cook-deb.jpg`:\n\n```yaml\nlayout: image-gallery\ntitle: Life at the Lab\ndescription: This page will be pretty soon.\nimages:\n - ../img/CASM-offsite.jpg\n - ../img/group-walk-mit.jpg\n - ../img/tim-cook.jpg\n - ../img/tim-cook-deb.jpg\n```\nNote that the order of the images in the `images:` list is how they will display on the site.\n\n## Edit the front page\n\nThe content of the front page is stored in **index.html**. This is one of the few files that is written in HTML instead of Markdown.\n\n## Edit copy on the Media Analytics page\n\nThe Media Analytics landing page can be edited via the Markdown file at **media-analytics/index.md**.\n\n## Edit copy on the Learning page\n\nThe Learning landing page can be edited via the Markdown file at **learning/index.md**.\n\n## Edit copy on the Cortico page\n\nThe Cortico page can be edited via the Markdown file at **cortico.md**.\n\n## Edit copy on the Admissions page\n\nThe Admissions page can be edited via the Markdown file at **admissions.md**.\n\n## Edit page layouts\n\nAll of the different types of pages specify which layouts they use in their front matter. To edit how those layouts are rendered, explore the files in **_layouts/** and the modular components in **_includes/**.\n\n## Modify the main navigation items\n\nEdit the entries in **_data/nav.yml**. The order in the file matches the order seen on the site.\n\n## Modifying the Filterable List logic used for Publications\n\nThe code for the filterable lists seen on the publications pages is stored in **js/filterable-list.js**. The live version uses a transpiled version of it in **js/filterable-list.min.js**. After making any desired changes, you can recompile the js by running the build script in the root directory called **build.sh**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmit-ccc%2Fsocial-machines.github.io","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmit-ccc%2Fsocial-machines.github.io","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmit-ccc%2Fsocial-machines.github.io/lists"}