[{"_1":2,"_175":-5,"_176":-5},"loaderData",{"_3":4,"_17":18,"_25":26,"_150":151},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7,"_13":14,"_15":16},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","theme","system","contrast","normal","routes/_layout",{"_19":-5,"_20":21,"_22":21,"_23":11,"_24":21},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_27":28,"_29":-5,"_30":11,"_31":11,"_32":33,"_34":35,"_36":-5,"_37":11,"_38":39,"_88":-5,"_89":90,"_139":-5,"_140":11,"_141":21,"_142":11,"_143":-5,"_144":11,"_145":-5,"_146":147,"_148":91,"_149":-7},"canonicalUrl","https://hub.docker.com/r/luismedel/clarin/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","luismedel","reponame","clarin","cloudBuildSource","isAutobuildsAvailable","repo",{"_40":41,"_42":43,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":55,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":74,"_79":11,"_80":81,"_85":33,"_86":87},"categories",[],"content_types",[44],"image","date_registered","2022-01-24T22:20:16.404938Z","description","Clarin is a simple and dogmatic static website generator.","is_private","last_updated","2022-08-06T17:25:30.807187Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[56],"application/vnd.docker.container.image.v1+json","name","pull_count",220,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","![Image](https://github.com/luismedel/clarin/raw/master/logo-w480.png)\n\nClarin is a simple and dogmatic static website generator.\n\nClarin takes a directory with content files and templates and renders them into a static HTML website. No more. No less.\n\n## Overview\n\nClarin isn’t flexible, nor optimized for speed, ease of use or configurability. It was modelled to satisfy [*my*](https://luismedel.com) personal needs and preferences (which could be yours' too if you're lucky enough!)\n\n## Usage\n\n```sh\n# docker run -v :/site luismedel/clarin \n```\n\n### Example\n\nSuppose you have your site in ```/home/johndoe/site```. Simply run:\n\n```sh\n# docker run -v /home/johndoe/site:/site luismedel/clarin \n```\n\nOr from the current directory:\n\n```sh\n# docker run -v $(pwd):/site luismedel/clarin \n```\n\n...where `````` is any clarin command (like ```build```, for example)\n\n\n## Clarin overview\n\n```sh\nUsage:\nclarin [--local] []\n\nCommands:\nbuild generates the site in /output\nwatch watches for changes and builds the site continuously\ninit inits a new site\nadd adds a new empty entry in /content\nversion prints the version number of Clarin\n\n--local overrides the value in site.ini and sets the site url\n to the current site local path\n\n defaults to current directory if not specified.\n```\n\n### Create a new site\n\n```sh\n# cd /home/johndoe/\n\n# clarin init my-site\n\n# cd /home/johndoe/my-site\n```\n\n### Edit the site config\n\n```sh\n# cat /home/johndoe/my-site/site.ini\ntitle = my new site\ndescription = my new site description\nauthor = author name\n\n; Root url for your site. Can be a local path too\nurl = http://127.0.0.1/\n\n; Defines how Clarin prints the dates when using the 'date' filter\ndateFormat = yyyy-MM-dd\n```\n\nNote the lack of quotes, double quotes and any other string delimiter for values. You can use them if you want, but they aren't needed.\n\n### Content and non-content files\n\nClarin looks inside the ```content``` directory. Files with .html, .md and .xml extensions are processed as content files. Everything else (css, images and anything else) is copied as-is to the ```output``` folder preserving the directory structure.\n\nFor content files Clarin expects the metadata, if any, to be defined in the first lines, between ```---``` lines.\n\n```\n---\ntitle: Content title\ndate: 20220114\ncategory: blog\n---\n\nYour content here.\n```\n\nYou can add as many metadata fields as you want. Just remember that:\n* Clarin won't render content with ```draft:true```.\n* The field ```category``` is needed for index tags to work (explained later).\n\nAlso, Clarin ignores any file starting with an underscore or dot, like ```_20220131-draft.md``` and ```.another-draft.md```.\nIf you want to ignore the full contents of a directory, place an empty file named ```.clarinignore``` in it.\n\n### Add new content\n\n```sh\n# cd /home/johndoe/my-site\n# clarin add\nAdded /home/johndoe/my-site/content/20220114-newentry.md\n\n# cat content/20220114-newentry.md\n---\ntitle: new entry\ndate: 20220114\ncategory: blog\ndraft: true\n---\n\nYour content here.\n```\n\n### Editing your content\n\nClarin uses a very simple and familiar syntax for your content tags:\n\n```sh\n# cat /home/johndoe/my-site/content/20220114-newentry.md\n```\n\n\n\n```markdown\n---\ntitle: new entry\ndate: 20220114\ncategory: blog\ndraft: true\n---\n\nFor this entry:\n- Was written on {date} (pretty formated as {date|date}).\n- Has category {category}.\n- The url is {url} (automatically generated).\n- The slug is {slug} (automatically generated if not present in metadata).\n- Is in the site {site.title}, at {site.url} (as you can see, you can use any field present in site.ini using the prefix 'site.').\n- Was generated on {sys.date|date} (sys.date is always the current date and time).\n```\n\nClarin expects some values to exists in order to work properly (but tries it's best to run ok if not present):\n\n* slug: used to generate the output filename. If not present, Clarin tries to get it from the source filename.\n* category: used for content filtering in the index tags.\n* date: used for ordering in the index tags.\n* draft: set to ```true``` if you want the entry to be ignored by Clarin.\n\n### Tag filters\n\nClarin supports the use of filters in the form ```{value|filter}``` to modify how your content tags will render:\n\n```\nupper Prints the value in UPPERCASE\nlower Prints the value in lowercase\ndate Prints the value using site.dateFormat (as defined in site.ini)\nrfc822 Prints the value as a RFC822 date (for atom feeds, basically)\n```\n\nAny other unknown filter will be trated as a date formatting pattern:\n\n* yyyyMMdd: Prints the value as ```yyyyMMdd```.\n* yyyy-MM-dd: Prints the value as ```yyyy-MM-dd```.\n* ...and so on.\n\n### About date values\n\nWhen using any of the date filters (```date```, ```rfc822``` and ```yyyyMMdd```) Clarin tries to parse the input value using one of the following formats:\n\n* yyyyMMdd\n* yyyy-MM-dd\n* yyyy.MM.dd\n* yyyy/MM/dd\n\n### Content urls\n\nYou can insert the url of a content in two ways:\n\n* Using the form ```{site.url}filename.html```\n* Using the sorthand ```{#}``` where `````` is the slug of the content you want to get the url of.\n\n### Create an index (aka 'index tags')\n\nYou can insert an index for your content using the following syntax in any content page:\n\n```html\n{%index||%}\n```\n\nor\n\n```html\n{%index|()|%}\n```\n\nFor example, to generate an index for all your entries with category 'blog' in your index.html file:\n\n```html\n

Welcome to my blog!

\n\t\t{title}\n\t

\n```\n\nAnd the same for Markdown content:\n\n```markdown\nWelcome to my blog!\n\t{%index|blog|\n\t- [{title}]({url}) %}\n```\n\nAnother example of how you can generate an atom.xml file for the last 10 blog entries:\n\n```xml\n\n\t{site.url} feed\n\t\n\t\n\t{site.url}\n\t{sys.date|RFC822}\n\t{%index|blog(10)|\n\t\n\t\t{url}\n\t\t\n\t\t{title}\n\t\t{site.author}\n\t\t{date|RFC822}\n\t\t

{excerpt}

\n\t\n\t%}\n\n```\n\nOf course, you can insert as many indices as you need:\n\n```markdown\nWelcome to my blog!\n\nHere you have my personal posts:\n\t{%index|personal|\n\t- [{title}]({url}) %}\n\nHere you have my programming posts:\n\t{%index|programming|\n\t- [{title}]({url}) %}\n```\n\n### Templates\n\nYou can place your templates under the 'templates' directory.\n\nTemplate files use the same exact syntax as the rest of the content files. The only difference is that Clarin will insert the current page contents where you place the ```{content}``` tag.\n\nSo, having this template in ```/templates/page.html```...\n\n```html\n\n\n\t\n\t\t\n\t\t{title}\n\t\t\n\t\n\t\n\t\t

{title}

\n\t\t{content}\n\t\n\n```\n\n...and this content in ```/content/20220114-hello.html```...\n\n```markdown\n---\ntitle: Hello!\ndate: 20220114\ncategory: blog\ntemplate: page.html\n---\n\n

Hello World!

\n```\n\n...you'll get the following output in ```/output/hello.html```.\n\n```html\n\n\n\t\n\t\t\n\t\tHello!\n\t\t\n\t\n\t\n\t\t

Hello!

\n\n\t\t

Hello World!

\n\t\n\n```\n\nMaybe you want to reuse some snippet in several templates. Supose you have this snippet in ```/templates/head.html```:\n\n```html\n\n\t\n\t{title}\n\t\n\n```\n\nYou can include the snippet in other templates using the ```{%inc|template%}``` tag:\n\n```html\n\n\n\t{%inc|head.html%}\n\t\n\t\t

{title}

\n\t\t{content}\n\t\n\n```\n\n### Build your site\n\nUse the ```build``` command.\n\n```sh\n# cd /home/johndoe/my-site\n# clarin build\n```\n\n#### Additional information\n\nPlase, refer to the [official Clarin repo](https://github.com/luismedel/clarin) to get more information and use examples.","has_starred","hub_user","immutable_tags_settings",{"_75":11,"_76":77},"enabled","rules",[78],".*","is_automated","permissions",{"_82":21,"_83":11,"_84":11},"read","write","admin","user","storage_size",864411097,"orgData","recentTags",[91,129],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":102,"_50":118,"_119":94,"_120":33,"_121":56,"_57":122,"_123":124,"_125":109,"_126":118,"_127":66,"_128":21},"content_type","creator",16388410,"digest","sha256:59c16d305e0be3d15a617363fb4efab09e0347d37a97ee01fed1f52e444067e1","full_size",103940939,"id",188789174,"images",[103],{"_104":105,"_95":96,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":98,"_63":66,"_117":-5},"architecture","amd64","features","","last_pulled","2026-09-24T17:57:24.034933326Z","last_pushed","2022-08-06T17:25:31Z","os","linux","os_features","os_version","size","variant","2022-08-06T17:25:30.586917Z","last_updater","last_updater_username","media_type","latest","repository",16314448,"tag_last_pulled","tag_last_pushed","tag_status","v2",{"_92":44,"_93":94,"_97":130,"_99":131,"_101":132,"_50":137,"_119":94,"_120":33,"_121":56,"_57":138,"_123":124,"_125":135,"_126":137,"_127":66,"_128":21},115928148,243380084,[133],{"_104":105,"_95":134,"_106":107,"_108":135,"_110":136,"_112":113,"_114":107,"_115":-5,"_116":130,"_63":66,"_117":-5},"sha256:e2da34dd0fcaf14f0ac83bb0d7abbc40d5d47ece5004f71a85f2a8b8d8fba66e","2026-09-13T00:16:05.153541996Z","2022-06-28T07:10:58Z","2022-06-28T07:10:57.175841Z","master","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"selectedTag","attestationsUrl","routes/_layout.r.$namespace.$reponame.tags",{"_38":152,"_159":160,"_146":173,"_174":11},{"_40":153,"_42":154,"_45":46,"_47":48,"_49":11,"_50":51,"_52":53,"_54":155,"_57":35,"_32":33,"_58":59,"_60":44,"_61":62,"_63":64,"_65":66,"_67":-5,"_68":62,"_69":70,"_71":11,"_72":33,"_73":156,"_79":11,"_80":158,"_85":33,"_86":87},[],[44],[56],{"_75":11,"_76":157},[78],{"_82":21,"_83":11,"_84":11},"tags",{"_161":162,"_163":-5,"_164":-5,"_165":166},"count",2,"next","previous","results",[167,170],{"_92":44,"_93":94,"_95":96,"_97":98,"_99":100,"_101":168,"_50":118,"_119":94,"_120":33,"_121":56,"_57":122,"_123":124,"_125":109,"_126":118,"_127":66,"_128":21},[169],{"_104":105,"_95":96,"_106":107,"_108":109,"_110":111,"_112":113,"_114":107,"_115":-5,"_116":98,"_63":66,"_117":-5},{"_92":44,"_93":94,"_97":130,"_99":131,"_101":171,"_50":137,"_119":94,"_120":33,"_121":56,"_57":138,"_123":124,"_125":135,"_126":137,"_127":66,"_128":21},[172],{"_104":105,"_95":134,"_106":107,"_108":135,"_110":136,"_112":113,"_114":107,"_115":-5,"_116":130,"_63":66,"_117":-5},[],"canDeleteTags","actionData","errors"]

luismedel/clarin

Tags for luismedel/clarin