Skip to content

Commit

Permalink
Updates tools
Browse files Browse the repository at this point in the history
  • Loading branch information
davidmerfield committed Feb 6, 2025
1 parent 4fa4f05 commit 054a1cb
Show file tree
Hide file tree
Showing 12 changed files with 93 additions and 16 deletions.
1 change: 1 addition & 0 deletions app/documentation/build/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ const handle = (initial = false) => async (path) => {
if (initial) return;
console.log("Rebuilding tools");
await tools();
return;
}

if (path.includes("images/examples") && path.endsWith(".png")) {
Expand Down
8 changes: 8 additions & 0 deletions app/documentation/build/tools.js
Original file line number Diff line number Diff line change
Expand Up @@ -181,10 +181,13 @@ const loadTool = async (category, tool) => {
$("h1").text() ||
(slug[0].toUpperCase() + slug.slice(1)).replace(/-/g, " ");

const subtitle = $("h2:first-of-type").text() || "";

$("h1").remove();

const result = {
title,
subtitle,
category,
html: $.html(),
updated,
Expand All @@ -207,6 +210,11 @@ const loadTool = async (category, tool) => {
return { name: p.trim() };
});

if (result.files) {
result.files = result.files.split(",").map(f => {
return { name: f, slug: f.trim().toLowerCase().replace(/\s/g, "-") };
});
}
return result;
};

Expand Down
5 changes: 4 additions & 1 deletion app/documentation/selected.js
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,10 @@ var TITLES = {
"who": "Who uses Blot?",
"developers": "Developers",
"json-feed": "JSON feed",
"posts-tagged": "A page with posts with a particular tag"
"posts-tagged": "A page with posts with a particular tag",
"ifttt": "IFTTT",
"soundcloud": "SoundCloud",
"youtube": "YouTube",
};

module.exports = function (req, res, next) {
Expand Down
2 changes: 0 additions & 2 deletions app/site/index.js
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,7 @@ const Express = require("express");
const dashboard = require("dashboard");
const documentation = require("documentation");
const mustache = require("helper/express-mustache");
const root = require("helper/rootDir");
const config = require("config");
const { join } = require("path");

const VIEW_DIRECTORY = config.views_directory;

Expand Down
5 changes: 5 additions & 0 deletions app/views/tools/README
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
https://www.notion.com/integrations/all

https://docs.buttondown.com/blogger

https://poe.com/chat/34uyn10thl7y2l7uj8y
4 changes: 4 additions & 0 deletions app/views/tools/automation/ifttt.html
Original file line number Diff line number Diff line change
Expand Up @@ -6,3 +6,7 @@

<h1>IFTTT</h1>

<h2>Automate publishing to your folder</h2>

<p></p>

2 changes: 1 addition & 1 deletion app/views/tools/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,6 @@ <h1>{{^category}}Tools{{/category}}{{#category}}{{title}}{{/category}}</h1>

<ul class="tool-list">
{{#tools}}
<li><a href="/tools/{{slug}}">{{#icon}}<img src="/tools{{{icon}}}" width="16">{{/icon}}<span class="a">{{title}}</span></a></li>
<li><a href="/tools/{{slug}}">{{#icon}}<img src="/tools{{{icon}}}" width="16">{{/icon}}<span class="a"><b>{{title}}</b><br>{{subtitle}} </span></a></li>
{{/tools}}
</ul>
4 changes: 3 additions & 1 deletion app/views/tools/newsletters/feedmail.html
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,6 @@
Platforms: Web
---

<h1>Feedmail</h1>
<h1>Feedmail</h1>

<h2>Deliver new posts by email</h2>
33 changes: 32 additions & 1 deletion app/views/tools/text-editors/bear.html
Original file line number Diff line number Diff line change
@@ -1,6 +1,37 @@
---
Link: https://bear.app/
Platforms: macOS, iOS
Price: Free with optional Pro subscription
Files: Markdown
---

<h1>Bear</h1>
<h1>Bear</h1>
<h2>How to blog with Bear</h2>

<p>Bear is a flexible and elegant writing app for macOS and iOS designed to help you capture ideas, take notes, and write long-form content. With its powerful Markdown support, customizable themes, and organizational tools like tags, Bear is a great choice for bloggers and writers who want a simple yet powerful tool for creating content.</p>

<h2>How to use Bear with Blot</h2>
<ol>
<li><strong>Download Bear:</strong> Get Bear from the <a href="https://bear.app/">official site</a>, the Mac App Store, or the iOS App Store. Install and open the app.</li>
<li><strong>Create site on Blot:</strong> <a href="/sites/sign-up">Sign up</a> and set up your site. Decide how you want to <a href="/how/sync">sync your folder</a> with Blot.</li>
<li><strong>Write a new post:</strong> Open Bear and create a new note. Use <a href="/how/files/markdown">Markdown</a> to structure your content with headings, lists, links, and images. Bear supports advanced Markdown features such as inline links, checkboxes, and code blocks.</li>
<li><strong>Export your post as Markdown:</strong> Use Bear’s export feature to save your note as a Markdown file. Go to the “More Options” menu (•••) and select <strong>Export</strong>, then choose <strong>Markdown</strong>.</li>
<li><strong>Publish your post:</strong> Save the exported Markdown file directly into the folder synced with Blot. Once saved, Blot will automatically publish your post to your site.</li>
</ol>

<h2>Why Use Bear?</h2>
<ul>
<li>Beautiful, distraction-free interface with customizable themes and typography.</li>
<li>Powerful organization tools, including tags and nested tags, to keep your notes and posts organized.</li>
<li>Markdown support for easy formatting, including inline links, code blocks, and more.</li>
<li>Seamless syncing across macOS and iOS devices using iCloud.</li>
<li>Export options for Markdown, PDF, and more to fit your workflow.</li>
</ul>

<h2>Additional Tips</h2>
<ul>
<li>Use Bear’s tagging system to organize drafts and published posts. Tags can be nested for better organization.</li>
<li>Leverage Bear’s Markdown formatting tips to create visually consistent and well-structured posts.</li>
<li>Enable Bear’s dark mode or choose a theme that’s comfortable for long writing sessions.</li>
<li>Bear Pro subscribers can use advanced features like cross-note links and custom export options to enhance their workflow.</li>
</ul>
23 changes: 21 additions & 2 deletions app/views/tools/text-editors/byword.html
Original file line number Diff line number Diff line change
@@ -1,8 +1,27 @@
---
Link: https://www.bywordapp.com/
Link: https://bywordapp.com/
Platforms: macOS, iOS
Price: Paid
Files: Markdown, HTML
---

<h1>Byword</h1>
<h2>Write your posts with Byword</h2>

<p>A <a href="/how/posts/markdown">Markdown</a> editor.</p>
<p>Byword is a minimalist writing app designed to make writing notes and long-form texts easier. With its Markdown support, Byword works well alongside Blot.</p>

<h2>How to use Byword with Blot</h2>
<ol>
<li><strong>Download Byword:</strong> Get Byword from the <a href="https://bywordapp.com/">official site</a>, the Mac App Store, or the iOS App Store. Install and open the app.</li>
<li><strong>Create site on Blot:</strong> <a href="/sites/sign-up">Sign up</a> and set up your site. Decide how you want to <a href="/how/sync">sync your folder</a> with Blot.</li>
<li><strong>Write a new post:</strong> Open Byword and start a new document. Use <a href="/how/files/markdown">Markdown</a> to structure your content with headings, lists, links, and images.</li>
<li><strong>Publish your post:</strong> Save your post directly into the folder synced with Blot. Once saved, Blot will automatically publish your post to your site.</li>
</ol>

<h2>Additional Tips</h2>
<ul>
<li>Use Markdown to maintain consistent formatting across all your posts. Byword’s Markdown preview makes it easy to check your work before saving.</li>
<li>Organize your Byword files by saving them in a structured folder hierarchy that matches your site.</li>
<li>Take advantage of Byword’s keyboard shortcuts for extra efficiency.</li>
<li>Byword supports advanced Markdown features like footnotes, tables, and cross-references, which Blot automatically converts to HTML for your site.</li>
w</ul>
1 change: 1 addition & 0 deletions app/views/tools/text-editors/word.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@
---

<h1>Microsoft Word</h1>
<h2>How to blog with Word</h2>

<p>This guide provides a brief overview on how to use Microsoft Word documents with a static site generator that supports DOCX file conversion.</p>

Expand Down
21 changes: 13 additions & 8 deletions app/views/tools/tool.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,24 +4,28 @@ <h1>{{title}}</h1>
<div style="flex-basis: 66.666%;">{{{html}}}


<br>
<br>
<br>
<hr>
{{> supported_file_list}}

<h2>Related tools</h2>

<ul class="tool-list">
{{#related}}
<li><a href="/tools/{{slug}}">{{#icon}}<img src="/tools/{{{icon}}}" width="16">{{/icon}}<span class="a">{{title}}</span></a></li>
{{/related}}
</ul>

</Div>
<div style="flex-basis: 33.333%;flex-shrink: 0;">
<h2>Website</h2>
<p><a href="{{{link}}}" target="_blank" rel="nofollow">{{link}}</a> &rarr;</p>
<h2>Category</h2>
<a href="/tools/{{category.slug}}">{{category.title}}</a>
{{#files.length}}
<h2>Files published by Blot</h2>
<ul class="clients files">
{{#files}}
<li><a href="/how/files/{{slug}}"><span class="a"><span class="icon-file-check"></span> {{name}} </span>{{> chevron}}</a></li>
{{/files}}
</ul>
{{/files.length}}
{{#price}}
<h2>Price</h2>
<p>{{price}}</p>
Expand All @@ -30,7 +34,8 @@ <h2>Platforms</h2>
<p>{{#platforms}}
{{{name}}}
{{/platforms}}</p>
</ul>
<h2>Category</h2>
<a href="/tools/{{category.slug}}">{{category.title}}</a>
</div>
</div>

0 comments on commit 054a1cb

Please sign in to comment.