Making Markdown Preview Work From Finder in OSX

The versatility of Markdown lies in its simplicity, making it one of the most effective tools for converting plain text to rich HTML. For those new to the world of Markdown, it’s a lightweight markup language that allows you to create structured documents with ease. However, there’s often a pesky hurdle to overcome: how can we preview Markdown files without the need to open a dedicated text editor or application? Fear not—using OSX’s Finder, you can preview these files as effortlessly as you would an image or PDF. In this guide, I’ll walk you through the steps to enable Markdown previews directly from Finder using a nifty tool called QLMarkdown. ...

October 15, 2021 · 2 min · 391 words

Migrating from LastPass to Self-Hosted Vaultwarden (Bitwarden)

If you’ve made the decision to transition from LastPass to a self-hosted password manager like Vaultwarden (a streamlined fork of Bitwarden), you’re likely in search of a reliable guide to facilitate the migration. Whether you’re running it locally through Docker Compose or looking to explore the self-hosted landscape, this post will walk you through the essential steps to ensure a smooth transition. Why Choose Vaultwarden? At its core, Bitwarden is an open-source password manager that not only allows easy imports from LastPass but also offers the flexibility of self-hosting. Vaultwarden, in particular, distills the original Bitwarden server code, making it lighter and easier to manage on personal servers. This means you can take control of your data while enjoying a user-friendly interface. ...

September 13, 2021 · 3 min · 484 words

Harmonizing Project Delivery: Satisfaction, Confidence, Comfort, Hope, Value, and Excitement

In the complex landscape of project delivery, it’s easy to feel like a soloist in a cacophonous orchestra. Striking the right chord—where every stage of the project resonates with client expectations—can be daunting. Beyond simply completing tasks on time and within budget, crafting a seamless, harmonious experience is essential for enhancing client satisfaction and bolstering your business’s reputation. So, how do we transform the dissonance of project delivery into a cohesive symphony of satisfaction, confidence, comfort, hope, value, and excitement? The answer lies in a well-coordinated delivery process that nurtures trust, promotes transparency, and consistently exceeds client expectations at every turn. ...

July 22, 2021 · 3 min · 565 words

Enhancing Relationships as an Introvert with Monica Personal CRM

As an introvert, nurturing relationships can often feel like navigating a labyrinth—rewarding but daunting. It’s not that I lack appreciation for personal connections; on the contrary, I value them deeply. However, the effort it takes to engage in meaningful conversations and keep track of important life details can sometimes be overwhelming. In my quest to find a balance, I turned to digital solutions designed to support relationship-building. Enter Monica, a Personal Customer Relationship Management platform (or Personal CRM, if you will). Think of it as a digital memory aid, collating essential details about your connections in a way that is both searchable and manageable. It’s a tool that allows introverts like myself to cultivate meaningful relationships without feeling swamped. ...

May 23, 2021 · 3 min · 485 words

Open Source Freedom: No Vendor Lock-In or Proprietary Systems

Open source. You’ve likely encountered this term as you’ve navigated the software landscape. At its core, open source refers to a type of software license that grants users the ability to view, access, modify, and distribute source code. This stands in stark contrast to proprietary software, where the source code remains under lock and key, creating barriers to audit, modify, or learn from it. Why does this matter? Because the choice between open source and proprietary systems can fundamentally shape your organization’s agility and resilience. ...

April 13, 2021 · 3 min · 491 words

Self Hosting Made Simple: Leverage the Power of Flat File Sites

In a digital landscape often cluttered with complex content management systems (CMSs), the charm of flat-file websites can easily be overshadowed. But here’s the twist: a flat-file site operates without a database, storing each piece of content in a separate file, typically in a straightforward language like HTML or Markdown. Why Choose Flat-File Sites for Self-Hosting Let’s start with the most compelling reason to consider a flat-file site for self-hosting: simplicity. Without the need to juggle a database, setting up your website becomes a breeze. This ease translates to fewer headaches down the road—particularly valuable for those of us who might not have extensive technical expertise or resources. ...

March 27, 2021 · 2 min · 357 words

Simplifying Your Documentation Workflow: Building a Knowledge Base with MKDocs and CI/CD Pipelines

In the realm of software development, effective documentation is not just a nice-to-have; it’s an essential cornerstone. It fosters clarity, accelerates onboarding for new team members, and ultimately enhances project outcomes. While constructing a knowledge base might not seem daunting at first glance, the maintenance of that documentation can quickly become a heavy lift. This is where MKDocs combined with CI/CD pipelines steps in, transforming a once tedious process into a seamless, automated workflow. ...

February 25, 2021 · 3 min · 460 words

Read a Filtered List of Files from a Directory and Ask the User to Choose One (Bash)

One of the standout features of Docksal is its extensibility through Bash scripting, making it a valuable tool for automating various tasks. A common scenario is the need to import databases when initializing projects. The snippet below serves this purpose by scanning a directory for database files and allowing the user to select which one to import. # Get a list of *.mysql | *.sql.gz | *.sql in /db/ and let the user choose which to import unset options i while IFS= read -r -d $'\0' f; do options[i++]="$f" done < <(find ${PROJECT_ROOT}/db/ -maxdepth 1 -type f \( -name "*.mysql" -o -name "*.sql.gz" -o -name "*.sql" \) -print0) echo "Press [Enter] to choose a DB to import" read -t5 -p "(times out in 5 seconds) " if [ $? -gt 0 ]; then echo "" echo "Timed out waiting for response. Skipping DB import..." else select opt in "${options[@]}" "Skip DB Import" do case $opt in *.mysql | *.sql.gz | *.sql) echo "Importing $opt ..." fin db import $opt break ;; "Skip DB Import") echo "Skipping DB Import..." break ;; *) echo "Invalid choice, please enter the number of your choice above." ;; esac done fi This script effectively searches a specified directory for files that match certain extensions and prompts the user to make a selection. The inclusion of a timeout is a thoughtful touch, especially for scripts designed to run unattended or as part of a larger automation workflow. ...

September 30, 2019 · 2 min · 369 words

Install and Enable GIT Large File Support in OSX

If you’re navigating the challenges of large files in your Git repository—think audio clips, videos, or substantial datasets—Git Large File Storage (LFS) is your ally. In essence, it replaces bulky files with lightweight text pointers within Git, while the actual content resides on a remote server, such as GitHub. This approach not only streamlines your repository but also enhances collaboration among team members. Let’s Get Started with GIT LFS on OSX: Install Git LFS First up, let’s get Git LFS installed using Homebrew. Open your terminal and execute the following command: brew install git-lfs Initialize LFS in Your Repository Navigate to your project directory. Once you’re there, kickstart Git LFS by running: git lfs install If everything goes as planned, you’ll see the reassuring message: “Git LFS initialized.” Identify Large Files With LFS set up, it’s time to pinpoint the largest files in your repository. This step is essential for determining what needs tracking. Execute this command: find ~/Documents/path/to/repo -type f -exec du -h {} + | sort -rh | head -n 10 This command will present your top ten largest files, providing clarity on what you might want to manage using LFS. Track File Types Now that you’ve identified the heavy hitters, instruct Git LFS to track specific file types. For instance, if you’re working with video files, you might run: git lfs track '*.mp4' To view a list of all the paths, files, and types you’ve chosen to track, simply run: git lfs track ...

October 9, 2018 · 2 min · 361 words