{"id":29079559,"url":"https://github.com/markusfisch/simsala","last_synced_at":"2025-06-27T17:08:14.527Z","repository":{"id":12349016,"uuid":"14993567","full_name":"markusfisch/simsala","owner":"markusfisch","description":"Static site editor and generator for the web","archived":false,"fork":false,"pushed_at":"2021-04-08T11:55:25.000Z","size":55,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2023-03-11T13:38:18.058Z","etag":null,"topics":["static-site-generator"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/markusfisch.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":"2013-12-06T21:13:47.000Z","updated_at":"2021-04-08T11:55:28.000Z","dependencies_parsed_at":"2022-09-24T17:20:12.129Z","dependency_job_id":null,"html_url":"https://github.com/markusfisch/simsala","commit_stats":null,"previous_names":[],"tags_count":0,"template":null,"template_full_name":null,"purl":"pkg:github/markusfisch/simsala","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markusfisch%2Fsimsala","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markusfisch%2Fsimsala/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markusfisch%2Fsimsala/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markusfisch%2Fsimsala/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/markusfisch","download_url":"https://codeload.github.com/markusfisch/simsala/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/markusfisch%2Fsimsala/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262298770,"owners_count":23289603,"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":["static-site-generator"],"created_at":"2025-06-27T17:06:32.310Z","updated_at":"2025-06-27T17:08:14.517Z","avatar_url":"https://github.com/markusfisch.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"simsala\n=======\n\nStatic site editor and generator for the web.\n\nFeatures\n--------\n\n* Generate a static web site from a tree of [Markdown][1] files.\n* Automatic generation of a nested site navigation.\n* Editor works on everything with a web browser. Even Opera Mini.\n\nHow to use\n----------\n\n### Setup\n\nSimply clone this repository into your web root:\n\n\t$ git clone https://github.com/markusfisch/simsala.git\n\nThen, create a __contents__ directory within the new simsala directory:\n\n\t$ mkdir simsala/contents\n\nYour [Markdown][1] files will go there. To start, you may leave that empty.\nNext you need to create a __layouts__ directory in simsala:\n\n\t$ mkdir simsala/layouts\n\nPut your layouts into that directory. For example, save this as contents.html\nin simsala/layouts:\n\n\t\u003c!doctype html\u003e\n\t\u003chtml\u003e\n\t\u003chead\u003e\n\t\u003cmeta charset=\"utf-8\"/\u003e\n\t\u003ctitle\u003e\u003c?= $title ?\u003e\u003c/title\u003e\n\t\u003clink rel=\"stylesheet\" type=\"text/css\" href=\"css/screen.css\"/\u003e\n\t\u003c/head\u003e\n\t\u003cbody\u003e\n\t\u003cnav\u003e\n\t\u003c?= $this-\u003enav() ?\u003e\n\t\u003c/nav\u003e\n\t\u003carticle\u003e\n\t\u003c?= $content ?\u003e\n\t\u003c/article\u003e\n\t\u003c/body\u003e\n\t\u003c/html\u003e\n\nWhy contents.html?\nA layout file corresponds to a content file if it has the same name or the\nname of the directory in which the content file is in.\n\nSo the most basic layout is contents.html since all content files are in\nthe contents folder.\n\n### Set password\n\nCalculate the MD5 sum of the password you like to use to access the web\ninterface. On Linux/BSD/OSX you can use md5sum:\n\n\t$ printf 'your-password' | md5sum\n\nNext, open simsala/index.php with a text editor and find this line:\n\n\t$app = new App(\n\t\t// MD5 sum of your password\n\t\t'0cd9686c955f3fdfead2081e7cb9eb27' );\n\nPut the MD5 hash between the single quotes.\n\n### Log in\n\nNow, open your web site with /simsala in your web browser:\n\n\thttp://example.com/simsala\n\nYou should see a login form. Give your password and press __Login__.\n\n### Edit\n\nStart creating files and folders as you like.\nAt any time, you may press __Publish__ to generate the HTML files in\nthe directory that contains simsala.\n\nSymbols \u0026 Methods\n-----------------\n\nSimsala provides the following symbols and methods to be used in your\nlayout files:\n\n* $title - name of a content file (- and _ are replaced with blanks)\n* $content - rendered content of a content file\n* $this-\u003enav( $dir ) - nested navigation tree, argument is optional and\n  defaults to content directory\n* $this-\u003emap( $dir ) - site map of given directory, argument is optional and\n  defaults to content directory\n\nAdvanced use\n------------\n\nIf you're using git for your project, it's probably better to add a subtree instead of just cloning simsala into your project:\n\n\t$ git subtree add --prefix simsala https://github.com/markusfisch/simsala.git master --squash\n\nThat way you can always update simsala to the latest version with:\n\n\t$ git subtree pull --prefix simsala https://github.com/markusfisch/simsala.git master --squash\n\n[1]:https://en.wikipedia.org/wiki/Markdown\n[2]:https://github.com/markusfisch/simsala-sample\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkusfisch%2Fsimsala","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmarkusfisch%2Fsimsala","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmarkusfisch%2Fsimsala/lists"}