From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id 2HdqLIAW22bFSAAAqHPOHw:P1 (envelope-from ) for ; Fri, 06 Sep 2024 16:49:36 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id 2HdqLIAW22bFSAAAqHPOHw (envelope-from ) for ; Fri, 06 Sep 2024 16:49:36 +0200 X-Envelope-To: patches@johnnyrichard.com Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=lists.sr.ht header.s=20240113 header.b=irNwBAcR; dkim=pass header.d=johnnyrichard.com header.s=key1 header.b=zP9JQCVZ; dmarc=pass (policy=quarantine) header.from=johnnyrichard.com; spf=pass (aspmx1.migadu.com: domain of lists@sr.ht designates 46.23.81.152 as permitted sender) smtp.mailfrom=lists@sr.ht ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=johnnyrichard.com; s=key1; t=1725634176; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=T31jEad8ho7ptEYHCTVFUJWiujbYDH5PyjS37mSjGkU=; b=Tvj8ebpAp64PxQPfW2PxSjovlbwNmXEZ1powdcaXXmHpr8tYEYcdKLiP4MqZBAnbzJ6tVy dZpbmyqk93ROc804hLl4xcpF8UTc0r5NFdT2mKhnmZKi/OwpLjAztO/BgWEi4YVTMizMeB O6ABf+zP/Zuz4mDg0ftIZjDe5LA2Y+wjIl+UF5q29bVwMgNN/YhH1kY33et5WtHSltFU+N m2IbJlbHulXs8EbU8kEqqmbWZ/NiRmumLu9xKig56LujSnTbshGWpFXrlc/WCk0bKkH25e GnOlBtLnUCpFwPf4JFDXAplmyMh+fYzS6byaIaOSoNFuzpcOBups8RmhbDgHgg== ARC-Seal: i=1; s=key1; d=johnnyrichard.com; t=1725634176; a=rsa-sha256; cv=none; b=XJLU0RSvTOWLqBrgzeFIKLCmCEdskYRIlx+Dc2Vq77iSt8NVM7yd5kcPCLxxq2/S2Gs5oU dPdnqj+FFy4p7BkcQdZdnN6tVXF5dmDp+Nex8Go8+cFDmuUMIjFkMmJs38Oe9MfZYFRaFB nRbLKGkB1b9vGcJWu4lN0XZ5clLi8bekPNFmNZwgrtt8yFEL0S98Ot2Bxtbwm4+skzI7UZ Ui4Bo3ZUeM5Pwtbi2JUW17j8chZveJeAHml3mem1yOc+Pl22WUxpQ6ve9ElpcLQBGZgJ1S 7hHMEclXI7P1JbyqNcW7SpyCrKHkOX+vgSDMX3BhHJtSrPHi2/JuBmS23kc+Zg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=lists.sr.ht header.s=20240113 header.b=irNwBAcR; dkim=pass header.d=johnnyrichard.com header.s=key1 header.b=zP9JQCVZ; dmarc=pass (policy=quarantine) header.from=johnnyrichard.com; spf=pass (aspmx1.migadu.com: domain of lists@sr.ht designates 46.23.81.152 as permitted sender) smtp.mailfrom=lists@sr.ht Received: from mail-a.sr.ht (mail-a.sr.ht [46.23.81.152]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 9CA31662BA for ; Fri, 06 Sep 2024 16:49:36 +0200 (CEST) DKIM-Signature: a=rsa-sha256; bh=6/ql5AcQgcCLspBETv3Z6DxLok+W4AsL/020geZgbLY=; c=simple/simple; d=lists.sr.ht; h=Date:From:To:Cc:Subject:References:In-Reply-To:List-Unsubscribe:List-Subscribe:List-Archive:List-Post:List-ID; q=dns/txt; s=20240113; t=1725634175; v=1; b=irNwBAcR2fYB24TIRDq6DvRk/VvpUn8R5H1O0xG62/+YDOoEF0eF8B8Pq3lzP1QNd1zh1qKv dgXXAAhhxkjTa8Z0rQbmXe2IkZwjXG7Zl+KtcE0lEESF0gD3KfNjQySpF0dEDbP40wCR75lc58l tpcSOhDY9uqzyb9pORCidMvA7dxNLWjC8m1urFRxK7ekOPmNmdQRjXiHkgxFEN6rf83WnA3Kvp8 U6vNpvtXD9/8TwOpLSXKooVpotkqH2kVka1X54dKV8HKz6BWNtcrkzvj49vsf2bw3gl4pSrCrLg wrKVQMzlKFGHp/gGkeQHlvkiALnjTlGYO68WNxpkBUBjw== Received: from lists.sr.ht (unknown [46.23.81.154]) by mail-a.sr.ht (Postfix) with ESMTPSA id 848EE2038A for ; Fri, 06 Sep 2024 14:49:35 +0000 (UTC) Received: from out-183.mta0.migadu.com (out-183.mta0.migadu.com [91.218.175.183]) by mail-a.sr.ht (Postfix) with ESMTPS id B0C792034F for <~johnnyrichard/olang-devel@lists.sr.ht>; Fri, 06 Sep 2024 14:49:34 +0000 (UTC) Date: Fri, 6 Sep 2024 16:49:10 +0200 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=johnnyrichard.com; s=key1; t=1725634173; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=T31jEad8ho7ptEYHCTVFUJWiujbYDH5PyjS37mSjGkU=; b=zP9JQCVZ58GOMWC8PuZxdZ9pg3wTI7ZhFNH/QoF5lLalOKZ9vMlwRm4tJWqAI/B5pKr18W q4RfCTsRzGbUBwv3KnzuqNjVB1s9xbBQqfjRIfbYZmWx2ToOlcekzTnpkYqjqJR1qt9/rW bfhjqp2jcT5QgK/2+5SD6+q1miqs4svDd7yOIZvoweWfabJN1XFgUvWa6bm4X8PBdzSM0q HD+Qmkj8GovAmfoN1xxdmzuQmYdS2UknA9OSKwJCYOY/cBR1+FLFaOvcGCNWWl3I7PzMvc d8tVpJQmbp3lxCHUBRUSSIie3li29ywnubPp8dw6Achvx4onNACfhYQZx8U+tw== X-Report-Abuse: Please report any abuse attempt to abuse@migadu.com and include these headers. From: Johnny Richard To: Carlos Maniero Cc: ~johnnyrichard/olang-devel@lists.sr.ht Subject: Re: [PATCH olang v1] docs: Create olang manual document bootstrap Message-ID: <6cf2oxsllqw7rz5kmtkp4xwkkmdbqwmaxex6axvblj4iw3esqv@7qkb4s34dhuo> X-Sourcehut-Patchset-Update: APPLIED References: <20240905193854.18350-1-johnny@johnnyrichard.com> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: X-Sourcehut-Patchset-Status: UNKNOWN List-Unsubscribe: List-Subscribe: List-Archive: Archived-At: List-Post: List-ID: ~johnnyrichard/olang-devel <~johnnyrichard/olang-devel.lists.sr.ht> Sender: ~johnnyrichard/olang-devel <~johnnyrichard/olang-devel@lists.sr.ht> X-Migadu-Flow: FLOW_IN X-Migadu-Country: NL X-Migadu-Spam-Score: -3.12 X-Spam-Score: -3.12 X-Migadu-Queue-Id: 9CA31662BA X-Migadu-Scanner: mx11.migadu.com X-TUID: It6fbFtlHHTl Thanks for reviewing it. I found few issues with the patch (build and styling) and adjusted in a fixup commit bellow: Build: https://builds.sr.ht/~johnnyrichard/job/1320980 To git.sr.ht:~johnnyrichard/olang b1023a7..be71d16 HEAD -> main ---->8---- Subject: [PATCH olang] fixup! docs: Create olang manual document bootstrap diff --git a/.build.yml b/.build.yml index 01f4aab..3cbba82 100644 --- a/.build.yml +++ b/.build.yml @@ -6,6 +6,7 @@ packages: - hut - clang - pandoc-cli + - texinfo environment: site: o-lang.org sources: diff --git a/docs/manual/contribution-guide.texi b/docs/manual/contribution-guide.texi index 4c6e458..856d0f6 100644 --- a/docs/manual/contribution-guide.texi +++ b/docs/manual/contribution-guide.texi @@ -6,7 +6,7 @@ the world. Everyone is welcome to join us. If you want to catch up the language development, you can subscribe to our mailing list or join the #olang IRC channel on Libera network. -Olang is hosted on a @strong{git repository} +Olang source code is available on @strong{git} @url{https://git.sr.ht/~johnnyrichard/olang} @c ---------------------------------------------------------------------------- @@ -136,15 +136,12 @@ Any additional comments not suitable for the changelog The actual patch (@code{diff} output). @end enumerate - Sometimes you might need to break down your patch into multiple patches. In this case a patchset should be sent. - Patchesets MUST contain a @strong{cover letter} followed by a good description. It is easily achievable with the @code{--cover-letter} argument available on @code{git format-patch} and @code{git send-email} commands. - @subsection Creating Patches You can create a patch using the command: @@ -231,7 +228,7 @@ $ git format-patch --cover-letter -M origin/main -o outgoing/ -v2 Whenever you need to reply emails comments, please avoid @url{https://en.wikipedia.org/wiki/Posting_style, top posting}, do -@strong{botton posting} instead. Read more about it here +@strong{bottom posting} instead. Read more about it here @url{https://useplaintext.email/#etiquette}. @c ---------------------------------------------------------------------------- @@ -246,7 +243,7 @@ Whenever you need to reply emails comments, please avoid Send a @strong{plain text} email to @email{~johnnyrichard/olang-devel+subscribe@@lists.sr.ht} to subscribe to our -deve mailing list. +dev mailing list. You should be able to find older threads by searching into our archives, which is hosted at @url{https://lists.sr.ht/~johnnyrichard/olang-devel}. diff --git a/docs/manual/style.css b/docs/manual/style.css index 41b1b3f..db32c05 100644 --- a/docs/manual/style.css +++ b/docs/manual/style.css @@ -1,32 +1,3 @@ -@font-face { - font-family: 'Red Hat Mono'; - font-style: italic; - font-weight: 300; - font-display: swap; - src: url(https://johnnyrichard.com/static/fonts/RedHatMono-Italic.ttf) format('truetype'); -} -@font-face { - font-family: 'Red Hat Mono'; - font-style: italic; - font-weight: 500; - font-display: swap; - src: url(https://johnnyrichard.com/static/fonts/RedHatMono-BoldItalic.ttf) format('truetype'); -} -@font-face { - font-family: 'Red Hat Mono'; - font-style: normal; - font-weight: 300; - font-display: swap; - src: url(https://johnnyrichard.com/static/fonts/RedHatMono-Regular.ttf) format('truetype'); -} -@font-face { - font-family: 'Red Hat Mono'; - font-style: normal; - font-weight: 500; - font-display: swap; - src: url(https://johnnyrichard.com/static/fonts/RedHatMono-SemiBold.ttf) format('truetype'); -} - :root { --background-color: #f4f4f4; --text-color: black; @@ -41,10 +12,6 @@ } } -h1, h2, h3, h4, h5, h6, b, strong { - font-weight: 500; -} - div.example { margin: 0; } @@ -54,12 +21,12 @@ body { color: var(--text-color); margin: 0; padding: 0 40px; + font-size: 11pt; + font-family: monospace; } -body, pre { - font-weight: 300; - font-family: "Red Hat Mono"; - font-size: 1.4rem; +.example-formatted { + font-family: monospace; } a { @@ -67,7 +34,7 @@ a { } body > * { - max-width: 1024px; + max-width: 800px; margin: 10px auto; } @@ -89,7 +56,6 @@ footer { } body > * { - line-height: 1.75rem; overflow: hidden; } diff --git a/docs/template.html b/docs/template.html index 0f5a207..be5cbf5 100644 --- a/docs/template.html +++ b/docs/template.html @@ -70,7 +70,7 @@

olang | O Programming Language