{"id":26694463,"url":"https://github.com/deeplearnphysics/blog","last_synced_at":"2026-02-23T02:36:47.885Z","repository":{"id":116515085,"uuid":"113320240","full_name":"DeepLearnPhysics/Blog","owner":"DeepLearnPhysics","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-17T01:29:17.000Z","size":264478,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":5,"default_branch":"develop","last_synced_at":"2025-07-09T04:41:51.898Z","etag":null,"topics":["css","html","jupyter-notebooks","pelican","python"],"latest_commit_sha":null,"homepage":null,"language":"Jupyter Notebook","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DeepLearnPhysics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-12-06T13:31:06.000Z","updated_at":"2022-11-11T18:28:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"31b6b5a0-c1c9-4dd2-8039-6be92c24f041","html_url":"https://github.com/DeepLearnPhysics/Blog","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DeepLearnPhysics/Blog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FBlog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FBlog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FBlog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FBlog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeepLearnPhysics","download_url":"https://codeload.github.com/DeepLearnPhysics/Blog/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeepLearnPhysics%2FBlog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29735759,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-23T02:24:00.660Z","status":"ssl_error","status_checked_at":"2026-02-23T02:22:56.087Z","response_time":90,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["css","html","jupyter-notebooks","pelican","python"],"created_at":"2025-03-26T18:29:37.158Z","updated_at":"2026-02-23T02:36:47.869Z","avatar_url":"https://github.com/DeepLearnPhysics.png","language":"Jupyter Notebook","readme":"[![Build Status](https://travis-ci.org/DeepLearnPhysics/Blog.svg?branch=develop)](https://travis-ci.org/DeepLearnPhysics/Blog)\n[![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://raw.githubusercontent.com/DeepLearnPhysics/Blog/master/LICENSE)\n\n# Blog\nA repository for the DeepLearnPhysics group [Blog](https://deeplearnphysics.org/Blog) webpage.\nThe `master` branch holds static HTML files generated by [Pelican](http://docs.getpelican.com/en/stable/) with the [flex theme](https://github.com/alexandrevicenzi/Flex). We use the [pelican-ipynb](https://github.com/danielfrg/pelican-ipynb) plugin to easily turn a juypyter notebook into a blog.\nThe `develop` branch holds the source code to generate the website.\n\n## Requirement\nYou need the python packages:\n* `pelican \u003e= 3.5.0`\n* `markdown \u003e= 2.6.9`\n\nAlso for `pelican-ipynb` plug-ins you need:\n* `jupyter \u003e= 1.0`\n* `ipython \u003e= 4.0`\n* `nbconvert \u003e= 4.0`\n\nIf you find that the above requirement for [pelican-ipynb](https://github.com/danielfrg/pelican-ipynb#Requirements) changed, please let us know or update it above!\n\n## How to contribute (develop)\nFor awesome you to help development, follow the following three steps: **installation**, **compilation**, **development**, and **publish**.\n\n### Installation\n1. Join the [web-blog](https://github.com/orgs/DeepLearnPhysics/teams/web-blog) github team\n2. Clone the repo: `git clone git@github.com:DeepLearnPhysics/Blog`.\n3. Make sure you are on the `develop` branch by `git branch`\n\n### Compilation\nBy compilation we mean generation of static HTMLs. This is fairly simple:\n1.  `make html`\n\n### Development\nOur development work is a process of modify-compile-check. The **first to-do** is:\n1. Open `pelicanconf.py` and **uncomment** the line `#SITEURL = ''`. This generates HTMLs to be viewed locally.\n2. `make devserver` then access `localhost:8000` on your browser. This runs a virtual pelican web server on your machine and allows you to browse the updated website contents all on your laptop.\n3. Make modifications you wish to make. `contents` directory is where you make a _blog post_.\n4. `make html` will update your local static website.\n\n### Publish\nAfter you finish your development work, if you want to publish your change on our website, you have to push your changes.\n1. Open `pelicanconf.py` and **comment out** the line `SITEURL = ''`. This generates HTMLs to be viewed on the shared remote server.\n2. `make html` and if you are running a local virtual server, `make stopserver`.\n3. Commit your changes to the develop branch.\n4. `git checkout master` ... the master branch holds static website contents.\n5. `cp -r output/* ./`\n6. `git add .`\n7. `git commit -m \"your message\"`\n8. `git push`\n\nDone!\n\n---\n\n### Jupyter notebook\nThe following are instructions copied from the [pelican-ipynb](https://github.com/danielfrg/pelican-ipynb) plugin repository.\n\nWrite the post using the Jupyter Notebook interface, using markdown, equations, etc.\n\nPlace the `.ipynb` file in the content folder and create a new file with the\nsame name as the ipython notebook with the extension `.ipynb-meta`.\nFor example, if you have `my_post.ipynb` create a `my_post.ipynb-meta`.\n\nThe `.ipynb-meta` should have the markdown metadata (note the empty line at the end, you need that)\nof a regular pelican article:\n\n```\nTitle:\nSlug:\nDate:\nCategory:\nTags:\nAuthor:\nSummary:\n\n```\n\n---\n\n### Copyright and license\n\nIt is under [the MIT license](/LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeplearnphysics%2Fblog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeeplearnphysics%2Fblog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeplearnphysics%2Fblog/lists"}