diff --git a/mkdocs/docs/archive/cm.archive/Feature Tracking.md b/mkdocs/docs/archive/cm.archive/Feature Tracking.md new file mode 100644 index 0000000..41a8009 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/Feature Tracking.md @@ -0,0 +1,83 @@ +# Feature Tracking ✨ + +> Keeping track of Change Maker's evolution. Stay updated on what's coming next! + +## Currently in Development πŸš€ + +Change Maker V4 is actively being developed by the bnkops team. Here's what's on the horizon: + +### Core Infrastructure Updates πŸ—οΈ + +- **🌐 DNS Integration** + - Seamless domain hosting under bnkops.com #not started + - Simplified domain management #in progress + - Integrated DNS configuration tools #not started + +- **⚑ One-Click Installation** + - Streamlined public access deployment #in progress + - Simplified setup process #in progress + - Reduced technical barriers #in progress + +### Enhanced Editor Experience πŸ“ + +- **🎨 Expanded Frontend Editor** + - Advanced markdown editing capabilities #Open + - Improved content management interface #Open + - Enhanced preview functionality #Open + - Real-time collaboration features #In Progress + +### Mobile Optimization πŸ“± + +- **πŸ“± Enhanced Mobile Features** + - Streamlined content uploading #Not Started + - Improved mobile UI/UX #In Progress + - Touch-optimized controls #Not Started + - Responsive design improvements #In Progress + +### Communication & Automation πŸ€– + +- **πŸ“¨ Local Communication Suite** + - Newsletter system integration #done + - Email targeting capabilities #done + - Advanced automation workflows #in progress + - Database integration options #in progress + +### Content Management πŸ“Š + +- **🏷️ Meta Properties System** + - Document state tracking (draft/published) #in progress + - Author attribution #done + - Publication timestamps #in progress + - Version control #in progresss + - Content lifecycle management #in pprgoress + +--- + +## Current Features Overview 🌟 + +For reference, here are some of our current notable features: + +- **πŸ“± Mobile-First Design** + - Responsive Web Build + - Responsive layout + - Cross-device compatibility + +- **πŸ” Search Capabilities** + - Real-time suggestions + - Keyword highlighting + - Instant results + +- **🎨 Accessibility** + - Dark/Light mode support + - Screen reader optimization + - Accessibility-first design + +- **πŸ”’ Privacy & Security** + - Self-hosted platform + - No external dependencies + - Complete data control + - VPN compatibility + +--- + +> πŸ’‘ **Want to stay updated?** [Subscribe to our newsletter](https://changemaker.bnkops.com) for development updates and release notifications. \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/Free(ish).md b/mkdocs/docs/archive/cm.archive/Free(ish).md new file mode 100644 index 0000000..bcadbbb --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/Free(ish).md @@ -0,0 +1,30 @@ +# Free(ish) + +Free(ish) is our way of saying that Changemaker does require an exchange; we ask that you voluntarily provide an email address. We do this because in political work, system security is paramount. If we uncover security vulnerabilities, it's crucial that we can contact you. + +We maintain a single mailing list and send updates approximately bi-weekly. Please join us! + +
+
+

Subscribe to Updates

+ + +
+ +
+ +
+ +
+ +
+ + +

+ Hi Friend! Subscribing here will get you weekly updates from The Bunker Ops Admin (Bunker Admin) Reed Larsen (thatreallyblondehuman). Expect personal, code, and political updates. +

+
+ + +
+
\ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/Who is bnkops.md b/mkdocs/docs/archive/cm.archive/Who is bnkops.md new file mode 100644 index 0000000..5bd079c --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/Who is bnkops.md @@ -0,0 +1,61 @@ +# Who is Bnkops? + +## We Are a Co-operative + +The Bunker Operations is a co-operative based in amiskwaciy-wΓ’skahikan (Edmonton). The administration team is comprised of settlers and we are grateful for all that the earth has provided us on this land. + +Our organized group comprises trusted collaborators, comrades, and co-conspirators who share common goals in maintaining, growing, and thriving in community πŸ€πŸ‘πŸ’œ. We provide comprehensive consulting services, web infrastructure, and resources to various organizations. + +You can see another of our projects here: + +[repo.bnkops.com](https://repo.bnkops.com){ .md-button } + +You have seen our Featured Partner banner above. We have a number of partners who we work with to provide services and support to our community. + +**Want to work with us in partnership?** + +Contact us: + +[Email](mailto:admin@bnkops.ca){ .md-button } + +--- + +## Members of Bnkops Change Maker Team + +### The Bunker Admin - Reed + +![Reed](image.png){ width="200" style="border-radius: 50%" align="right" } + +The Bunker Admin is the primary administrator of the Change Maker system. They are responsible for the overall operation of the system and the development of the software. + +Reed is a settler living in amiskwaciy-wΓ’skahikan (Edmonton). Their family has been living between Treaty 6 and 7 lands for 3 generations. Blessed with the opportunity to live and work on this land, they are grateful for all that the earth has provided them. + +Reed is a human of many talents. They love to learn; often sporadically and in great bursts of excitment for a new topic, thing, or idea. They have a dry sense of humor and a love for the absurd. Catch them at a the dingiest dvd rental store, or the most obscure of bookstores, or sipping oat milk lattes at a local cafe. + +They have enjoyed many different labors in their time, including: + +- πŸ πŸ”¨ **Working** in the construction industry, specifically in housing +- πŸ“šπŸ‘¨β€πŸ« **Thriving** as a teacher, specifically with children and youth teaching english +- πŸŽ“πŸ“Š **Studying** as a student, in the field of political science and Alberta political identity +- πŸŽ“πŸ‘” **Laboring** as a Student leader, including as a President to the University of Alberta Students' Union +- πŸŒ±πŸ—£οΈ **Lobbying** as a political advocate, specifically for students, green energy, education, and the environment +- 🌈πŸ’ͺ **Organizing** as a community organizer, with groups like Pride Corner and Tawaw outreach +- πŸ’»πŸŒ **Coding** as developer, specifically in web development and design +- πŸŽ¨πŸ–ŒοΈ **Creating** art, specifically in the form of painting and drawing + +**Known Aliases:** + +- thatreallyblondehuman πŸ‘±β€β™€οΈπŸ‘±β€β™‚οΈ +- canadianforsure πŸ‡¨πŸ‡¦ +- bunker admin 🏒 + +[Learn more about Reed in depth](https://repo.bnkops.com/thatreallyblondehuman/whomst.html){ .md-button } + +[Contact Reed](mailto:reed@bnkops.ca){ .md-button } + +### The Bunker Strategist - Shayla Breen + +The Bunker Strategist is responsible for the strategic direction of the Change Maker project. They are the supporting role to the Bunker Admin and help to guide the project in the right direction. + +[Contact Shayla](mailto:shayla@bnkops.ca){ .md-button } + diff --git a/mkdocs/docs/archive/cm.archive/Why Change Maker.md b/mkdocs/docs/archive/cm.archive/Why Change Maker.md new file mode 100644 index 0000000..44e61c3 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/Why Change Maker.md @@ -0,0 +1,840 @@ +# Why Change Maker + + + + + + + +
+
+
+ + + + + +
+

Build your power, don't pay for it.

+
+ +
+
+
πŸ’Ύ
+

Your Data, Your Rules

+

Keep your digital footprint truly private. Your site and content are built locally, on your machine. That way, we can't peek, we can't leak, we can't sell what we can't see. Simple as that.

+
+ +
+
πŸ“š
+

Community Library

+

Write your site in the same manner as a repository. Over time, your repository gets bigger. Like a library with good sustainable funding, your repository can become a beacon for community information.

+
+ +
+
⚑
+

Digital Independence

+

Why fund the competition? Most software companies are digital mercenaries, working for the highest bidder. Take control of your digital destiny without feeding the corporate beast.

+
+ +
+
⏩
+

Lightning Fast

+

Got thoughts? Put 'em online faster than you can say "corporate overlords." No tech degree required.

+
+ +
+
πŸ€”
+

Level Up

+

Start with basic text, end up mastering web development. It's like a game, but the final boss is digital dependency.

+
+ +
+
πŸ’«
+
+ + Free(ish)! + +
+

Just drop us your email and get full access. No catches, no surprise bills, no selling your soul to Silicon Valley.

+
+
+ +
+ Do you own your data, or are you just renting it? +
+
+ +
+

"Oh so its kinda like nexopia for politics however all on my computer?"

+

- Change Maker's First User

+
+ + + + + +
+

The Original Internet Promise

+

Remember when the internet was meant to be everyone's digital commons? That vision still lives, though it's been overshadowed by corporate platforms. What began as an open space has largely transformed into a marketplace, with companies repackaging freely available solutions behind sleek marketing.

+

Enter Software-as-a-Service (SaaS), the modern equivalent of cure-all tonics 🐍🎩. "Subscribe to solve all your problems!" they say - just keep paying monthly until those fees stack higher than a mortgage.

+

At bnkops, we believe in community power. By sharing our activist toolkit, we're supporting our communities, organizations, and fellow changemakers in building a more equitable world. These tools can help us organize against the rise of facism in ways we haven't even imagined yet.

+

This project returns to the internet's original promise - putting digital power back in the hands of everyday people on everyday computers. While we might not have flashy features or marketing budgets, we offer something better: a as secure as we can make it, functional activist platform available, and it's free(ish).

+

The best part? Your data stays completely yours. The system runs locally, so we can't access your information or suddenly start charging fees. Your movement, your data, your control. ✊

+
+ + + +
+
+
+

1990s

+

Free Internet

+ Open protocols +
+
+

2000s

+

Big Tech Rise

+ Centralization +
+
+

2010s

+

SaaS Trap

+ Subscriptions +
+
+

2020s

+

Surveillance Era

+ Data sold +
+
+

NOW

+

Time to Act

+ Take control +
+
+ +
+
+
+
+
+
+
+
+
CORPORATE EVIL LEVEL: CRITICAL
+
+
+ +
+

Corporate Evil is the Default Selection

+

We will not defeat capitalism and the march towards facism by giving our data and dollars to companies that would sell us to the highest bidder. Nearly all software corporations are already selling out your movements data.

+ + A brief list of examples: + +

Google has billion dollar contracts with Israel to serve the technology that enables genocide.

+ +

Microsoft is the technology provider of the US military.

+ +

OpenAI (chatGPT) is used by intelligence agencies

+ +

Mailchimp, owned by Inuit, fired nearly 1,800 employees and slanderd them all

+ +

Twitter is owned my a manic billionaire that is a maga weirdo

+ +

Facebook chats have been used to imprison abortion rights advocates

+ +

A Nationbuilder founder Robert Greenwald is close with Mark Zuckerberg and its initial founders include prominent republicans. Plus the service is effectively banned in Europe over privacy concerns

+
+ +
+

Sharing is caring. Knowledge is power. Creation is a community process.

+

Want to read more theory on this? Read some papers:

+ +
+ +
+

It's Truly Free(ish)

+

All we ask in return is your email.

+

By joining our platform, you gain access to a system that bnkops excels in. We are a collective dedicated to positive change, and while we do charge for our expertise, your email helps us stay connected and grow together. Consider partnering with us in the future to collaborate with like-minded individuals who are committed to building a better tomorrow.

+

Our platform is designed to be accessible to everyone, regardless of their financial situation. We believe that everyone should have access to the tools they need to make a difference in the world, and we're committed to providing those tools to you for free.

+

We ask for your email also so we can reach you with updates; the only way to stay secure is to keep developing and updating our systems. We promise not to spam you, and you can unsubscribe at any time.

+
+ +
+
+ +

Subscribe

+ +
+

+ +

+

+ +

+
+ +

+ + +

+ +

+ +

+
+
\ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/assets/toaster1.png b/mkdocs/docs/archive/cm.archive/assets/toaster1.png new file mode 100755 index 0000000..77a0066 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/assets/toaster1.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/index.md b/mkdocs/docs/archive/cm.archive/blog/index.md new file mode 100755 index 0000000..3691d90 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/index.md @@ -0,0 +1,3 @@ +# Blog + +This is the archive of blog posts from previous bnkops changemaker deployments. diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Admin Log.md b/mkdocs/docs/archive/cm.archive/blog/posts/Admin Log.md new file mode 100755 index 0000000..4d8c9a0 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Admin Log.md @@ -0,0 +1,108 @@ +--- +author: The Bunker Admin +date: + created: 2024-11-26 +pin: true +--- + + +# Admin Logs + +The admin log is a one stop shop for all the updates and changes made to the Change Maker system. + + + +# Development Path +This app is under intensive development. Updates will be pushed on completion. V4 will aim to be a stable release. + +Priority development right now: + +- Install script that simplifies public deployment +- Nocodb integration for database + +bnkops is working on V4 right now, which will also be free. Core features coming include: + +- DNS (domain) hosting services under bnkops.com +- One click install script for public access +- Expanded editor with more standard markdown editing features and content management +- Expanded mobile features, such as content uploading and improved ui +- Options to install local newsletter, email targeter, automation systems, and database integrations +- Meta properties for documentation for states like draft, publish, author, publication time, etc. + +## Features for Fun +Time allows we will also work to release some updates that are not core components however are "nice to have". + +- Emoji integration with editor + +# Updates + +## Change Maker V3.8.3 28/11/2024 + +- More input commands finished up. +- Lots of random bug fixes; line spacing and stuff like that. +- Added drag and drop functionality for the file manager. + +## Change Maker V3.8.2 - 26/11/2024 + +- Fixed a series of bugs and overhauled the insert function for links. Moved it to a static bar at the top of the editor. Like this more for sure. Needs further updates yet however working well. +- Fixed a bunch of lesser bugs; reload triggers and whatnot where generally broken. + +## Change Maker V3.8.1 - 25/11/2024 + +Holy cow a lot of updates done. + +- Listmonk up and config files for up and down fixed +- Big rework of Changemaker website, including new landing page and new features +- Lots of bug fixing and general improvements +- wrote some fun special things, like the custom code for things like the music player and newsletter signup. + +## Listmonk Integration - 19/11/2024 + +Version 3.5 ships with Listmonk. Going to integrate a home page for the system; a sort of login page. Listmonk is a fully featured messaging app; allowing messaging across several mediums. Simplicity combined with power; everything we like. + +[Listmonk](https://listmonk.app/) + +## MkDocs Config Save Button Addition - 04/11/2024 + +Added manual save functionality for mkdocs.yml to prevent accidental publishing: + +- Removed auto-save for config file only +- Added save button (only visible when editing mkdocs.yml) +- Added save status indicators and feedback +- Regular markdown files still auto-save as before + +Modified files: +- Editor.js: Added save button + disabled config auto-save +- No backend changes required + +Button appears next to settings icon when editing mkdocs.yml. + +## Admin Log: Preview URL Toggle Update - 2024/04/11 + +Added local/production preview toggle in editor UI: + +- Added getMkdocsUrl() to constants.js +- Created PreviewToggle component with Local/Prod indicator +- Updated preview panel to use dynamic URL switching +- Default: prod (changemaker.bnkops.com) +- Toggle: local (localhost:4000) + +Files modified: +- constants.js: Added URL switcher +- Editor.js: Added toggle + URL handling +- New: PreviewToggle.js + +No breaking changes. Maintains all existing functionality. + +## Change Maker V3.2 - Nov. 4 2024 + +V3.2 updates: + +- Reworking of position of link suggestions and improved speed in search. + +## Change Maker V3.1 - Nov. 4 2024 + +Change Maker V3.1 includes the following updates: + +- Improved linking systems; changed from using wikilinks to standard markdown links for compatibility with site builder +- General bug fix's qr \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Newsletter 1.0.md b/mkdocs/docs/archive/cm.archive/blog/posts/Newsletter 1.0.md new file mode 100755 index 0000000..ad77f7c --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Newsletter 1.0.md @@ -0,0 +1,95 @@ +--- +# For full documentation on blog post settings, see: +# https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/#usage + +draft: false +authors: + - The Bunker Admin +date: + created: 2025-01-14 +--- + + +# Newsletter 1.2 + +Hay! It's Reed. A rant, some media, and a ask inside; whatcha think? check it out? πŸ€”πŸ€·β€β™‚οΈ + + + +Yoooooooooo, + +Suh friend! In this update I rant about Facebook, provide some media, and have a ask for you. Check it out below! + +# Facebook Deleted! + +
+ NocoDB +
+ +Facebook is swiftly going to follow Twitter in toxicity. Invest elsewhere or fall to the trap of arguing with conservative bots. Like legit, [Facebook is leaning into bots](https://www.theverge.com/2025/1/3/24334946/meta-ai-profiles-instagram-facebook-bots), and for sure bad actors are salivating at the chance to unleash programmatic content. The same company that caused BREXIT WITH JUST MEMES now has AI posting on it's own. They tried to "sell" it to you. Its joever. Every and any account could be a bot. It is simple to take your likeness. They don't respect your data; well proven. There comes a day when Facebook sells digital ghosts; the ability to talk to a dead loved one. Literal demon daemons. + +**Dead! Dusted! Deleted!** My personal account down. + +Well, in 30 days. Facebook knows it's a addictive thing and it tries super hard to impress the value of it's service as you leave. It took like a dozen clicks, confirmations, lists of things, surveys, and bunch of other stuff just to be told my info won't be up for deletion for 30 days. So will see if we go back πŸ€·β€β™‚οΈ + +
+ NocoDB +
+ +Anyway, it actually did feel something doing this. Right on the delete button, I could feel my stomach somewhat drop. Some sort of anxiety, like the same feeling coming off a drug. Take it from a addict, those sweaty palms for sure a sign of how addictive this thing is. + +To combat that, here I am sharing. Hope to hear from you. Legit is me over here typing away. + +
+ NocoDB +
+ +--- + +Try out [Change Maker](https://changemaker.bnkops.com/manuals/)? I use the system to make this newsletter :) + +### [Code Releases](https://drive.proton.me/urls/Q83BEPSPHC#sP5y9Zh8rWlp) + +### Password: Hurray! + +--- + +# Found Media + +I love old, weird, odd, and often times horrific media. Like gory, rough, catholically evil things. + +
+ NocoDB +
+ + +**[Berserk](https://archive.org/details/berserk-episode-16)** is one of these kinds of show. It tortures. It is evil. It is gross. Toxic. Male gazy, because shocker, the leading characters are men. I project transness onto the character Griffith and probably will do a cosplay sometime. Death is prolific throughout. However the absolute destruction of the characters, the way it builds them up for the evil, is next to none. It leaves a solid slime of 'wtf' on the brain. + +Talking about catholically evil things; this take-down by **[CJ the X of Jordan Peterson suits](https://www.youtube.com/watch?v=LpHFcylNGqg)** is sublime. Plus you can learn a bunch about suits while watching it. + +Okay for one more evil recommendation; have you seen squid game? Did you like it? + +You would love **[Psycho Pass](https://www.youtube.com/results?search_query=pyschopass)**. This show passes itself off as a copy buddy show at the start, and has plenty of tropes, however, the representation of the absolute nature of a surveillance state combined with out-right "brain-in-a-jar" facist thinking is a combination that is surreal. I am 2/3rds done and best guess is that the show argues how if we live in the surveillance [panopticon](https://en.wikipedia.org/wiki/Panopticon) and the state still has authority; it will abuse its power. It grapples with the question; what happens when the state is the only remaining source of violence? + +Season two also has a wonderful line about medical care for mental health; healthcare, without thought for the individual, is also violent in nature. For each, their own, is the only way. This is why we must protect peoples rights to self-determiniation, even those we consider criminal. + +--- + +# Help! + +Friend, I need your help. I need to get out and more and chat with people. I have already written up a bunch of content that I am hoping to chat with people about. I need a hand sharing it. Do you think anyone in your network would like to chat more about: + +- [What distributed digital organizing is](https://repo.bnkops.com/thatreallyblondehuman/Thoughts%20%F0%9F%A4%94/Distributed%20Digital%20Organizing%20is%20The%20Way%20Out.html) +- [How to do politics online without supporting billionaire oligarchs who want your every secret](https://repo.bnkops.com/thatreallyblondehuman/Thoughts%20%F0%9F%A4%94/If%20you%20do%20politics%20who%20is%20reading%20your%20secrets%20-%20why%20you%20should%20de-corp%20your%20software%20stack.html) +- [Ways to build followings and not get got in the age of surveillance capitalism](https://repo.bnkops.com/thatreallyblondehuman/Thoughts%20%F0%9F%A4%94/How%20not%20to%20get%20got%20making%20content%20v2.html) + +This email is tied to my personal inbox. If you share this and introduce me to a colleague I would be thrilled and will owe you a solid. + +If you would like to chat any of the above, or just be pen pals through email, it would be wonderful. I am embracing slower and thoughtful communication; come along with me? + +--- + +Anyway, I think that is all for now folks! Wishing y'all peace and prosperity. + +
image
+ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/The Revolution Will Not Get Likes.md b/mkdocs/docs/archive/cm.archive/blog/posts/The Revolution Will Not Get Likes.md new file mode 100755 index 0000000..53482a4 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/The Revolution Will Not Get Likes.md @@ -0,0 +1,523 @@ +--- +Author: The Bunker Admin +date: + created: 2024-11-20 +--- + +# The Revoltion Will Not Get Likes + + + + + + + +
+
+
+
+ + + + +
+
+ +
+
+ + + + + + + +## The Social Media Harm Machine + +There isn't a single activist in my social circles that actually _wants_ to be on social media. Being a social media manager for a movement is like being voluntarily assigned to digital self-harm duty. Getting doxxed has become such a rite of passage for leftists, we might as well start handing out merit badges. Meanwhile, platforms are openly throttling progressive content while boosting blonde trad wives explaining why women shouldn't have opinions. X has basically become 4chan's corporate cousin, and yet here we all are, still posting. + +## Why Though? Like, Seriously, Why? + +Why do our movements keep feeding energy into platforms owned by techbro capitalists who are literally selling our DMs to cops? Why give free content to companies that see our existence as a Terms of Service violation? + +Let's call it what it is: **Addiction**. + +I (your friendly neighborhood bnkops admin) am straight up admitting it – I'm an addict. The doomscroll is real. My amygdala is basically playing Russian roulette every time I refresh: will it be a happy puppy or literal war crimes? Vegas slots probably have better odds for my mental health. + +## Breaking Free (No Judgment Zone) + +Like any addiction, people need to find their own path out. I've gone cold turkey on mobile apps. Started writing on platforms I actually control. Pro tip: try going phone-free for just one hour a day. A 15-minute walk without your digital pacifier hits different – clarity comes through like [*chef's kiss*]. + +No shade though – addiction is addiction. And like any vulnerability, oppressors know exactly how to weaponize it. The right wing troll swarms are like digital locusts, except locusts eventually leave. Try blocking the endless wave of MAGA bots – it's like playing whack-a-mole with a broken mallet. + +## The Dystopia Is Not Coming - It's Livestreaming + +These platforms are increasingly becoming real-world threat multipliers. Elon Musk and Trump have basically built digital brownshirt armies. Coming soon to a Twitter near you: Musk playing innocent about how his "metaphorical" AI-generated hate posts led to actual violence. + +We have written at length about how leftists are making themselves vulnerable to attack by being on these platforms. The time to transition off was yesterday. + +## The Liberal Delusion + +Liberals be like "don't worry, privacy laws will save us!" while we're already living in cyberpunk minus the cool aesthetics. Surveillance capitalism has pulled off the ultimate protection racket – pay us or you're not safe (but also you're not safe if you do pay us). + +The liberal brain rot runs so deep they're trusting Elon "Definitely Not A Bond Villain" Musk with global satellite communications. Local activists using Gmail might as well CC their strategy docs directly to the opposition. Bonus points: your entire contact list gets implicated too! + +## It's Getting Worse, Fast + +With the subtlety of a brick through a Starbucks window, these platforms are ramping up suppression of any non-capitalist thought. Today it's shadowbans, tomorrow it's sharing your location with "concerned authorities," and next week it's "predictive threat assessment" (aka pre-crime). + +Straight bet: when mass deportations hit the US, every major social platform will have their data ready to go faster than you can say "just following orders." + +## Your Digital Exit Strategy (You're Gonna Need It) + +If you're running an org heavy on social, here's your homework: + +- Export your followers/following lists NOW. When (not if) you get banned, you'll want that rolodex +- Get those emails and phone numbers like you're a club promoter in 2005 +- Meet your actual neighbors (yes, the ones behind those scary doors called "outside") +- Return to analog: Flyers, stickers, graffiti. Make the streets your timeline + +## Money Talks, So Stop Paying Your Oppressors + +Stop throwing money at social media ads. You're basically paying your executioner for a slightly sharper axe. If you must spend cash on promotion: + +- Plaster every telephone pole in a 5-mile radius +- Become the person coffee shop bulletin boards fear +- Make your car a rolling billboard +- Find local podcasters who aren't Joe Rogan clones +- Turn the subway into your personal art gallery + +## The Offline Revolution + +Remember: The revolution will not be monetized. It won't have sponsored content. It won't be algorithm-optimized. And it definitely won't fit in your Instagram grid. + +But it might just start with a conversation at your local coffee shop, a flyer in someone's hand, or a really spicy piece of bathroom graffiti. + +## Read More + +Want more info to covince you to leave these platforms: + +- [Twitter is Dead, Long Live X](https://repo.bnkops.com/thatreallyblondehuman/Thoughts%20%F0%9F%A4%94/Twitter%20is%20Dead%2C%20Long%20Live%20X%20---%20Why%20You%20Should%20Abandon%20X.html) +- [Are you a leftist? Who is reading your secrets?](https://repo.bnkops.com/thatreallyblondehuman/Thoughts%20%F0%9F%A4%94/If%20you%20do%20politics%20who%20is%20reading%20your%20secrets%20-%20why%20you%20should%20de-corp%20your%20software%20stack.html) +- [Distributed Digital Organizing is the Way Out](https://repo.bnkops.com/thatreallyblondehuman/Thoughts%20%F0%9F%A4%94/Distributed%20Digital%20Organizing%20is%20The%20Way%20Out.html) +- [How To Not Get Got Making Content](https://repo.bnkops.com/thatreallyblondehuman/Thoughts%20%F0%9F%A4%94/Distributed%20Digital%20Organizing%20is%20The%20Way%20Out.html) + +_"The master's tools will never dismantle the master's house, but they might help us build our own somewhere else."_ +– Audre Lorde (but make it digital resistance). + +
+
+ Remember: You Are Not Your Likes +
+ +
+

The revolution will not be monetized.

+

The revolution will not have sponsored content.

+

The revolution will not be algorithm-optimized.

+

The revolution will not be in your feed.

+
+ +
+

Immediate Actions:

+ +
+ +
+ "The master's tools will never dismantle the master's house."
+ - Audre Lorde +
+
+ + + + diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Update 1.md b/mkdocs/docs/archive/cm.archive/blog/posts/Update 1.md new file mode 100755 index 0000000..8776eee --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Update 1.md @@ -0,0 +1,139 @@ +--- +# For full documentation on blog post settings, see: +# https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/#usage + +draft: false +authors: + - The Bunker Admin +date: + created: 2024-11-29 +--- + + +# Update + +This is a test + + + +![image.png](image.png) + +[Why Change Maker](Why Change Maker.md) + +[Test](https://repo.bnkops.com/Home.html){ .md-button } + +!!! note "Test" + Hello this is a test note + +test (1) +{ .annotate } + +1. this is a test annotation + +**bold** + +
+ +- __Test__ + + --- + + Test + +- __Test__ + + --- + + Test + +- __Test__ + + --- + + Test + +- __TEst__ + + --- + + TEst + +
+ +
+
+ +

Subscribe

+ +
+

+ +

+

+ +

+
+ +

+ + +

+ +

+ +

+
+
+ +Hay send this email! + +Imagine the email content here! + +[test](mailto:admin@thebunkerops.ca){ .md-button } \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Update 2.md b/mkdocs/docs/archive/cm.archive/blog/posts/Update 2.md new file mode 100755 index 0000000..2346536 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Update 2.md @@ -0,0 +1,116 @@ +--- +# For full documentation on blog post settings, see: +# https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/#usage + +draft: false +authors: + - The Bunker Admin +date: + created: 2024-12-04 +--- + +# Change Maker Update V3.8.7 + +Okay so we have a decent new update! Introducing + +- **Landing Page** - Change Maker landing page for navigating application. +- **NocoDB** - Database management for all and any data. + + + +# Landing Page + +![landing1](landing1.png) + +The landing page is our newest custom built addition to the Change Maker system. It is going to be the central hub for managing the applications of Change Maker. + +The User Management grants different users access to the Landing Page and is only visible to the account administrator. + +!!! Warning "Security" + The landing page is not yet secure for production use. Make sure to set access rules inside each application based on documentation. We also recommend using Cloudflare Zero Trust access rules to secure applications for two-factor authentication. + +# [NocoDB]( https://docs.nocodb.com/) + +![database](database.png) + +### "NocoDB is a no-code database platform that allows teams to collaborate and build applications with ease of a familiar and intuitive spreadsheet interface. This allows even non-developers or business users to become software creators." - NocoDB + +This is such a powerful app! Import data from any source *cough Nationbuilder cough* and start building value based on that data. You can make forms, kabans, and move data between Change Maker databases with ease. As we grow out the network of apps, this database center will be what our automation systems reference and Change Maker dashboards are built on. A great way to save a tonne of dollars is to reduce how many contacts you store elsewhere and start storing them for free locally. + +[NocoDB Manual](/manuals/NocoDB/){ .md-button } + +--- + +So if you are on the mailing list these features are in Change-Maker-V3.8.7. Sign up for the newsletter to be kept up to date with releases: + +
+
+ +

Subscribe

+ +
+

+ +

+

+ +

+
+ +

+ + +

+ +

+ +

+
+
\ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Update 3.md b/mkdocs/docs/archive/cm.archive/blog/posts/Update 3.md new file mode 100755 index 0000000..14ba895 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Update 3.md @@ -0,0 +1,78 @@ +--- +# For full documentation on blog post settings, see: +# https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/#usage + +draft: false +authors: + - The Bunker Admin +date: + created: 2025-01-09 +--- + +# Update 1.0 + +Hello new friends! Thanks for joining us on this journey. It has been awhile since we provided a update and so we have a lot of exciting updates to share with you. These include: + +- Development +- AI Model Hosting +- User Management System +- Updated User Interface +- Simple Button + + + +## Development + +The next quarter we are focused on two things: fast value adds and stable production ready installation scripts. This means we are going to be adding new, already secure, and production ready applications to the Change Maker system and updating the current applications to be more stable and secure on installation. + +Following the addtion of the fast value applications and a stable installation script, we will begin the process of integratting all the applications across the system. The original peices of Change Maker, like the tech running the [repo](https://repo.bnkops.com/Home.html), will also be updated to more stable and secure systems. + +### Fast Value +We have currently flagged the followng applications for integration into Change Maker: + +- **HiEvents** is a event management software. They offer effortless event management for conferences, nightclubs, and everything in between. +- **Mattermost** is a full slack alternative. They offer full data sovereignty and security for your teams sensitive communications. +- **BluSky** is a federated social media platform. Using your existing Change Maker domain, you can host your own BluSky server for complete control over your social media presence. +- **Budibase** is a low-code app builder. It serves as a comprehensive alternative to Google Forms and Sites, enabling the creation of applications like Email Targeter. +- **n8n** is a low-code automation platform. As the leading automation software for technical teams, it may enable seamless automation across your entire Change Maker installation. +- **Monica** is a relationship-focused CRM system. It excels in politics by prioritizing genuine connections and offering clear visualization of households and community relationships. +- **Answers** is a team-oriented Q&A platform. It streamlines volunteer organization and helps teams quickly understand various campaign roles and responsibilities. + +### Production Ready Installation Scripts + +General development is focused getting the current build-out to production ready with a one command install on most standard operating systems. This will include a new configuration script and a new start script with more detailed instructions on how to up Change Maker. + +### Timing + +We suspect this round of development to take 3-4 months, depending on other workloads. If anyone is interested in helping out, please reach out to us at [admin@bnkops.ca](mailto:admin@bnkops.ca). + +## AI Model Hosting + +We are also working to move all our systems of of Meta products; this includes this the models running [Daisy AI](https://repo.bnkops.com/Daisy%20AI%20%F0%9F%8C%BB/Daisy.html). + +We are also working on building our first server to host AI models so we can move our entire development stack to a secure and private environment. + +## User Management System + +Right now we ask users to create access rules for the Change Maker network of apps using [Cloudflare Zero Trust](https://www.cloudflare.com/en-gb/products/zero-trust/). As a alternative to this cloud system, we are going to be integrating [Keycloak](https://www.keycloak.org/) into the Change Maker system ASAP. This will allow for a more secure and robust user management system that is localized to the installation device and can be used across all Change Maker applications. + +## Updated User Interface + +The system also now ships with a updated login page for the landing page, landing page, and introduces dark mode to the editor. + +![alt text](image-1.png) + +![alt text](image-2.png) + +![alt text](image-3.png) + +## Simple Button + +Simple Button is now available! You can find it under the [**Simple Button**](https://changemaker.bnkops.com/manuals/button) page on our manuals site. We are going to integrate the Simple Button into the Change Maker system to allow for easy campaign button integration. + + + + + + + diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Update 4.md b/mkdocs/docs/archive/cm.archive/blog/posts/Update 4.md new file mode 100755 index 0000000..7199430 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Update 4.md @@ -0,0 +1,28 @@ +--- +# For full documentation on blog post settings, see: +# https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/#usage + +draft: false +authors: + - The Bunker Admin +date: + created: 2025-01-09 +--- + +# Update 4.0 + +Okay taking notes as I go this time around. Follow along as I do a clean up of the Change Maker system. + + + +## Development + +Okay starting off by doing a file clean-up. Lots of baggage in the system right now. + +1. Cleaned up the code and home.html file. +2. Creating a stremalined home page. + + +DS + + diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Update 5.md b/mkdocs/docs/archive/cm.archive/blog/posts/Update 5.md new file mode 100644 index 0000000..3dcb120 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Update 5.md @@ -0,0 +1,48 @@ +--- +# For full documentation on blog post settings, see: +# https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/#usage + +draft: false +authors: + - The Bunker Admin +date: + created: 2025-02-19 +--- + +# Changemaker 3.9.4 + +We have jumped several updates! A quick overview: + +# New Functionality + +## Monica CRM + +Changemaker now bundles with Monica! This CRM is geared towards personal and familiar relations; way more useful for mapping connections between people then a sales based CRM. + +## Annoucement Bar Editor + +Users can now edit the annoucement bar from inside changemaker itself. + +![alt text](image-4.png) + +Also updated the editor panels for the home.html and the mkdocs.yml for consitent styling across all editor panels. + +## Simple Button Updates + +Simple Buttons now have a `copy` features for all text components, making them more versatile and usable even if the user doesnt have a emial client configured. Clicking the `send email` button now also automatically copies email body text to clipboard. + +![alt text](image-5.png) + +## Onboarding Flow + +A all new first build experience is completed, which steps the user through deploying their first Changemaker + +![alt text](image-6.png) + +## General Bug Fixes + +- Cleaned up landing page and env files +- Moved a lot of configuration to root +- Fixed bug for saving the home.html +- Moved the home.html template editor to main panel. +- Updated all the editor panels. diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Update 6.md b/mkdocs/docs/archive/cm.archive/blog/posts/Update 6.md new file mode 100644 index 0000000..1845824 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Update 6.md @@ -0,0 +1,33 @@ +--- +# For full documentation on blog post settings, see: +# https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/#usage + +draft: false +authors: + - The Bunker Admin +date: + created: 2025-03-03 +--- + +# Changemaker 3.9.9 + +Big update! We have officially gotten [Syncthing](https://syncthing.net/) integrated! Rigorous testing is still needed to find out hitches however any docs written with this system now can be shared directly and built with another ChangeMaker system; also opening the door for connected & communicative systems. + +[The original theory is coming together](https://repo.bnkops.com/What%20is%20a%20Repo%20and%20Why%20Make%20One%20%F0%9F%92%AD%20%F0%9F%8D%84.html). + +## Next Objectives + +**Video Server** +I have decided to park finding a video hosting solution for the time being; this may require that bnkops just hosts a dedicated web server node. Trying to build this using the changemaker script would be tricky however hosting it on a dedicated machine a lot easier. + +Looking into MediaCMS: https://github.com/mediacms-io/mediacms + +And also looking into Owncast: https://owncast.online/ + +**Pangolin** +A open sourced self-hosted alternative to cloudflared tunnels has been released: https://github.com/fosrl/pangolin?tab=readme-ov-file + + + + + diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/Update 7.md b/mkdocs/docs/archive/cm.archive/blog/posts/Update 7.md new file mode 100644 index 0000000..4f33ede --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/Update 7.md @@ -0,0 +1,23 @@ +--- +# For full documentation on blog post settings, see: +# https://squidfunk.github.io/mkdocs-material/setup/setting-up-a-blog/#usage + +draft: false +authors: + - The Bunker Admin +date: + created: 2025-03-20 +--- + +# Changemaker 3.9.9.1 + +Okay latest update is Apache Answers added to the system. + +Tonnes of backend support stuff and bug fixes: + +- new system for domain updating (still needs some work) + + + + + diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/database.png b/mkdocs/docs/archive/cm.archive/blog/posts/database.png new file mode 100755 index 0000000..2607292 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/database.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/image-1.png b/mkdocs/docs/archive/cm.archive/blog/posts/image-1.png new file mode 100755 index 0000000..fdfd951 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/image-1.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/image-2.png b/mkdocs/docs/archive/cm.archive/blog/posts/image-2.png new file mode 100755 index 0000000..73b8277 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/image-2.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/image-3.png b/mkdocs/docs/archive/cm.archive/blog/posts/image-3.png new file mode 100755 index 0000000..163d3be Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/image-3.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/image-4.png b/mkdocs/docs/archive/cm.archive/blog/posts/image-4.png new file mode 100644 index 0000000..e947911 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/image-4.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/image-5.png b/mkdocs/docs/archive/cm.archive/blog/posts/image-5.png new file mode 100644 index 0000000..a8d2962 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/image-5.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/image-6.png b/mkdocs/docs/archive/cm.archive/blog/posts/image-6.png new file mode 100644 index 0000000..b47af07 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/image-6.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/image.png b/mkdocs/docs/archive/cm.archive/blog/posts/image.png new file mode 100755 index 0000000..d8489c1 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/image.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/landing1.png b/mkdocs/docs/archive/cm.archive/blog/posts/landing1.png new file mode 100755 index 0000000..1bebbd4 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/blog/posts/landing1.png differ diff --git a/mkdocs/docs/archive/cm.archive/blog/posts/myfirst.md b/mkdocs/docs/archive/cm.archive/blog/posts/myfirst.md new file mode 100755 index 0000000..a9dd6ae --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/blog/posts/myfirst.md @@ -0,0 +1,11 @@ +--- +date: + created: 2023-12-31 +--- + +# Learning the Blog System + +Just now learning how the blog system works in mkdocs. + + +Never actually had to use this before; was not creating content like this. I think this is how we will integrate the changelog and other updates. Further, want to make any posts made in the listmonk to show up as blog posts, if wanted. \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/index.md b/mkdocs/docs/archive/cm.archive/index.md new file mode 100644 index 0000000..28c4424 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/index.md @@ -0,0 +1,25 @@ +--- +title: Welcome to Bnkops Change Maker V3 +template: home-cm-archive.html +--- + + + + + + + + + + + + + + + + + + + + + diff --git a/mkdocs/docs/archive/cm.archive/intro.webm b/mkdocs/docs/archive/cm.archive/intro.webm new file mode 100644 index 0000000..adee62f Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/intro.webm differ diff --git a/mkdocs/docs/archive/cm.archive/itsfree.gif b/mkdocs/docs/archive/cm.archive/itsfree.gif new file mode 100644 index 0000000..bcaa18b Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/itsfree.gif differ diff --git a/mkdocs/docs/archive/cm.archive/javascript/extra.js b/mkdocs/docs/archive/cm.archive/javascript/extra.js new file mode 100755 index 0000000..e69de29 diff --git a/mkdocs/docs/archive/cm.archive/known bugs.md b/mkdocs/docs/archive/cm.archive/known bugs.md new file mode 100644 index 0000000..331413e --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/known bugs.md @@ -0,0 +1,7 @@ +# Known Bugs + +## Blog in Editor + +- A person can open the blog folder and its contents however the live preview is not able to update. +- we need a backup instructional page. + diff --git a/mkdocs/docs/archive/cm.archive/livepreview.png b/mkdocs/docs/archive/cm.archive/livepreview.png new file mode 100644 index 0000000..9c8a9c6 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/livepreview.png differ diff --git a/mkdocs/docs/archive/cm.archive/logo.svg b/mkdocs/docs/archive/cm.archive/logo.svg new file mode 100644 index 0000000..289868f --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/logo.svg @@ -0,0 +1 @@ + \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/manuals/Backend & Editor.md b/mkdocs/docs/archive/cm.archive/manuals/Backend & Editor.md new file mode 100755 index 0000000..e1a5574 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/manuals/Backend & Editor.md @@ -0,0 +1,320 @@ +# Backend & Editor + + + + + + + +
+

+ A powerful documentation system that puts you in control. Edit your content locally or remotely with plain text and Markdown, while seeing your changes instantly. +

+ +
+
+
πŸ“ Local-First Editing
+

All content is stored locally in plain text and Markdown format. Edit with your favorite tools, no vendor lock-in.

+
+ +
+
πŸ‘οΈ Live Preview
+

See your changes instantly with built-in preview. No need to save or publish - everything updates in real-time.

+
+ +
+
πŸ“± Multi-Environment
+

Work seamlessly across desktop and mobile environments. Your workflow, your choice.

+
+ +
+
πŸ”§ Full Customization
+

Access and modify any part of the system. Your site, your rules, your customizations.

+
+
+
+ + + +## Desktop Environment + +Upon first build, bnkops Change Maker V3 comes bundled with the current theme, documentation, and front-page. All can be updated within the app in plain text and notes are written using [Markdown](Simple Markdown Guide.md). + +![backend.png](https://changemaker.bnkops.com/backend.png) + +### Live Preview +Click the double headed arrow to open and close live preview panel. The live preview panel shows your site updates inside the editor live. All changes to .md files are automatically pushed to site; no need to save or manage publication details. V4 will ship with state management (publish, draft, etc.) however if you want to work with drafts we suggest that users write files in [obsidian](obsidian.md) and then copy/paste content to site. + +![alt text](image-11.png) + +### Files +You will have a files section, which allows you to create, delete, and organize your websites structure. + +!!! note "Hidden Content" + Folders that start with a period (.example) are hidden from navigation in cmeditor and public site. If using [obsidian](obsidian.md) as content management system, this allows for folders to contain files, images, gifs, and website organization essentials without making them public. V4 will come with more fine grain control of what files are served to public and cmeditor. + +![](files2.png) + +### Editor + +The editor is where you can write and edit your content. The editor is a plain text editor that supports markdown. [Markdown](Simple Markdown Guide.md) is a simple way to format text that is easy to read and write. + +![alt text](image.png) + +### Backlinks +The backlinks panel on the right hand side is where your you can monitor your internal linking. See where all your files are being referenced and if internal linking is working properly. + +![Backlinks](backlinks.png) + +### Settings +Along the top bar are the settings. The double arrows opens/closes the live preview. The cog icon opens the `mkdocs.yml` which is how you set your sites features, plugins, and layout. The table icon opens the `home.html` in which you can edit your websites home page. + +![alt text](image-1.png) + +### mkdocs.yml + +![alt text](image-2.png) + +The mkdocs.yml is accessed by clicking the cog icon or by opening the mkdocs.yml file inside your top level /Change Maker V3 folder. This is a plain text file. Edits made to this file, upon save, reload site and update universally. If preview shows site down, it is because syntax for your .yml file is incorrect. To fix, you can check the guides, or you can ask any capable LLM for assistance. See [Customize Your Landing Page](Customize%20Your%20Landing%20Page.md) for prompting manual. + +Change Maker ships with several dozen features pre-installed and a navigation tree. Features, plugins, and references can be found on the [Material for MkDocs](https://squidfunk.github.io/mkdocs-material/setup/) site. Many future features will ship as features that are enabled through this plain text system. + +[Check out Material for MkDocs Documentation](https://squidfunk.github.io/mkdocs-material/setup/){ .md-button } + +#### Change Maker mkdocs.yml + +??? "mkdocs.yml Configuration" + ```yaml + site_name: Change Maker # The name of the site + site_description: A powerful documentation system combining simplicity with professional features. # A brief description of the site + site_url: https://changemaker.bnkops.com/ # The URL where the site is hosted + site_author: Bunker Ops # The author or organization responsible for the site + site_dir: docs # The directory where the documentation files are stored + + theme: + logo: logo.svg # The logo file for the site + name: material # The theme name, in this case, 'material' + custom_dir: docs/overrides # Directory for custom theme overrides + palette: + scheme: slate # The color scheme for the theme + primary: amber # The primary color for the theme + accent: deep purple # The accent color for the theme + features: + - navigation.sections # Enable navigation sections + - navigation.instant # Enable instant navigation + - navigation.instant.progress # Show progress in instant navigation + - navigation.instant.preview # Enable instant preview in navigation + - navigation.tracking # Enable navigation tracking + - navigation.indexes # Enable navigation indexes + - toc.integrate # Integrate table of contents + - content.code.copy # Enable copy button for code blocks + - navigation.path # Show navigation path + - navigation.top # Enable top navigation + - navigation.footer # Enable footer navigation + + markdown_extensions: + - pymdownx.highlight: + anchor_linenums: true # Enable line numbers in code blocks + line_spans: __span # Add spans to lines in code blocks + pygments_lang_class: true # Use Pygments language class for code blocks + - pymdownx.inlinehilite # Enable inline highlighting + - pymdownx.snippets # Enable snippets + - pymdownx.superfences # Enable superfences for code blocks + - admonition # Enable admonitions + - pymdownx.details # Enable details extension + - attr_list # Enable attribute lists + + extra_css: + - stylesheets/extra.css # Additional CSS file for custom styles + copyright: Copyright © 2024 The Bunker Operations # Copyright information + + extra: + generator: false # Disable generator meta tag + social: + - icon: material/web # Icon for the social link + link: https://repo.bnkops.com/Home.html # URL for the social link + + plugins: + - social # Enable social plugin + - search # Enable search plugin + + nav: + - Welcome to Bnkops Change Maker: index.md # Navigation link to the welcome page + - Why Change Maker: Why Change Maker.md # Navigation link to the 'Why Change Maker' page + - Bnkops Deploy: bnkops Deploy.md # Navigation link to the 'Bnkops Deploy' page + - Manuals: # Navigation section for manuals + - Getting Started: manuals/index.md # Link to the 'Getting Started' manual + - Prerequisites: manuals/prerequisites.md # Link to the 'Prerequisites' manual + - Installation: manuals/Installation.md # Link to the 'Installation' manual + - Backend & Editor: manuals/Backend & Editor.md # Link to the 'Backend & Editor' manual + - Simple Markdown Guide: manuals/Simple Markdown Guide.md # Link to the 'Simple Markdown Guide' manual + - Use Obsidian as Site Editor: manuals/obsidian.md # Link to the 'Use Obsidian as Site Editor' manual + - Customize Your Landing Page: manuals/Customize Your Landing Page.md # Link to the 'Customize Your Landing Page' manual + - Example Political Apps: manuals/Examples.md # Link to the 'Example Political Apps' manual + - Get Online: manuals/Get Site Online.md # Link to the 'Get Online' manual + - Visit repo.bnkops.com for more!: https://repo.bnkops.com/Home.html # External link to the repository + - Admin Log: Admin Log.md # Navigation link to the 'Admin Log' page + ``` + +### Navigation +Site wide navigation can be set purposefully by declaring it inside the .yml file or can be left to automatic alphabetical rendering. To switch to alphabetical approach, delete nav section in .yml file. Hybrid approaches are possible for things like blogs; see [Material for MkDocs ](https://squidfunk.github.io/mkdocs-material/setup/setting-up-navigation/?h=navigation)for more. + +![alt text](image-3.png) + +### QR Code Maker + +Qr code maker is a feature that allows you to generate QR codes for your site. This is useful for sharing your site with others. You can access the feature by clicking on the icon above the editor or by typing [[qr]] in the editor. + +![alt text](image-5.png) + +![alt text](image-6.png) + + +### Landing Page HTML Panel +Click on the table icon to open the landing page HTML panel. See [Customize Your Landing Page](Customize%20Your%20Landing%20Page.md) +for more instruction for updating this section. + +![alt text](image-4.png) + +## Mobile Environment +The mobile development currently deploys folded on load. This can be intimidating on first glance; trust us it is okay. To get to editor smoothly: + +1. Select a file and collapse the file menu +2. Close the preview menu by clicking the double header arrow icon +3. Collapse the backlinks section + +#### Editing on Mobile Browser +![MobileScreen2](MobileScreen2.png) + +## Diving Further +The entire site is built locally, which means all your files are available for updates locally. You can use any editor, such as VSCode, Obsidian, Texteditor, or your preferred platform to do site wide updates. As there are no blackbox code sections, you can access and modify any part of the system. + +![alt text](image-13.png) + +### extra.css +Want to spruce up your site even further? Access the extra.css file `docs/stylesheets/extra.css` and add in any site wide css styling you would like to add. Shipped by default are code block improvements. + +![alt text](image-12.png) + +### Again, Learn More At Mkdocs-Material +The system uses [mkdocs-material](https://squidfunk.github.io/mkdocs-material/) as the backend that builds your site. Material for Mkdocs is also a open-source project that has a massive community behind it. They have extensive documentation to setup a vast array of [features and customization](https://squidfunk.github.io/mkdocs-material/setup/). + +Exciting to us, and coming to you all soon, is support for site creation in over [60 languages.](https://squidfunk.github.io/mkdocs-material/setup/changing-the-language/?h=languag) and built in features like [data privacy](https://squidfunk.github.io/mkdocs-material/setup/ensuring-data-privacy/). + +[Check out Material for MkDocs Documentation](https://squidfunk.github.io/mkdocs-material/setup/){ .md-button } + +![](thumbsup.gif) \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/manuals/Build Site.md b/mkdocs/docs/archive/cm.archive/manuals/Build Site.md new file mode 100755 index 0000000..13cb922 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/manuals/Build Site.md @@ -0,0 +1,165 @@ +# Building Your Custom Site + +Getting started with Change Maker is simple and flexible. Here are the steps to create your own custom site from scratch. + +## Starting from Scratch + +Your site only needs a few things to get started: + +**Docs folder:** This is where all your content will live. You can organize your content into subfolders and files as needed. + +**Configuration file:** This file contains the settings for your site, such as the site title and description. + +**Navigation:** This text defines the structure of your site, including the order of pages and the hierarchy of the navigation. + +### Docs + +1. **Backup the Docs Folder**: Before making any changes, it's a good idea to backup the `docs` folder. This ensures you have a copy of the original content and all these manuals. + +2. **Create a New Folder**: Create a new folder called `docs` in the root directory. This will be the root folder for your custom site. + +3. **Add Your Content**: Add your content to the `docs` folder. You can create subfolders and organize your content as needed. + +### Configuration + +The most basic configuration for your site is the `mkdocs.yml` file. This file contains the site title, description, and other settings. + +???+ "Basic mkdocs.yml Configuration" + ```yaml + title: My Custom Site + description: This is my custom site. + ``` + +You can find all the configuration options on the mkdocs documentation page: + +[MkDocs documentation](https://squidfunk.github.io/mkdocs-material/setup/){ .md-button } + +**The Bunker Operations Current Configuration:** + +??? "Bunker Operations mkdocs.yml Configuration" + ```yaml + site_name: Change Maker + site_description: A powerful documentation system combining simplicity with professional features. Own your documentation, data, and design; don't rent it. + site_url: https://changemaker.bnkops.com/ + site_author: Bunker Ops + site_dir: docs + + theme: + logo: logo.svg + name: material + custom_dir: docs/overrides + palette: + scheme: slate + primary: amber + accent: deep purple + features: + - navigation.sections + - navigation.instant + - navigation.instant.progress + - navigation.instant.preview + - navigation.tracking + - navigation.indexes + - toc.integrate + - content.code.copy + - navigation.path + - navigation.top + - navigation.footer + - header.autohide + + markdown_extensions: + - pymdownx.highlight: + anchor_linenums: true + line_spans: __span + pygments_lang_class: true + - pymdownx.inlinehilite + - pymdownx.snippets + - pymdownx.superfences + - admonition + - pymdownx.details + - attr_list + - md_in_html + - footnotes + - pymdownx.emoji: + emoji_index: !!python/name:material.extensions.emoji.twemoji + emoji_generator: !!python/name:material.extensions.emoji.to_svg + + extra_css: + - stylesheets/extra.css + - https://fonts.googleapis.com/icon?family=Material+Icons + + copyright: Copyright © 2024 The Bunker Operations - Built with Change Maker + + extra: + generator: false + social: + - icon: material/web + link: https://repo.bnkops.com/Home.html + + plugins: + - social + - search + - blog: + draft_on_serve: false + + nav: + - Welcome to Bnkops Change Maker: index.md + - Why Change Maker: Why Change Maker.md + - Bnkops Deploy: bnkops Deploy.md + - Admin Log: blog/index.md + - Install & Manuals: + - Getting Started: manuals/index.md + - Prerequisites: manuals/prerequisites.md + - Installation: manuals/Installation.md + - Reset & Build: manuals/Build Site.md + - Backend & Editor: manuals/Backend & Editor.md + - Simple Markdown Guide: manuals/Simple Markdown Guide.md + - Commands: manuals/Commands.md + - Use Obsidian as Site Editor: manuals/obsidian.md + - Customize Your Landing Page: manuals/Customize Your Landing Page.md + - Example Political Apps: manuals/Examples.md + - Get Online: manuals/Get Site Online.md + - Visit repo.bnkops.com for more!: https://repo.bnkops.com/Home.html + - Feature Tracking: Feature Tracking.md + - Who is bnkops: Who is bnkops.md + ``` + +### Navigation + +The navigation for your site is defined in the mkdocs.yml file. This file contains the structure of your site, including the order of pages and the hierarchy of the navigation. You have two options for defining the navigation: + +1. **Manual Navigation**: You can manually define the navigation in the `mkdocs.yml` file. This gives you full control over the structure of your site. For example + +???+ "Manual Navigation Example" + ```yaml + nav: + - Home: index.md + - About: about.md + - Contact: contact.md + ``` + +2. **Automatic Navigation**: You can let MkDocs automatically generate the navigation based on the structure of your `docs` folder. This is the default behavior if you don't define the navigation in the `mkdocs.yml` file. Mkdocs will generates navigation via alphabetical order of the files in the `docs` folder. + +For example, if you have the following files in your `docs` folder: + +???+ "Example Docs Folder Structure" + ``` + docs/ + index.md + about.md + contact.md + ``` +These will load up in the navigation as follows: + +???+ "Generated Navigation Example" + ``` + - About + - Contact + - Home + ``` + +!!! tip "index.md" + The `index.md` file is always the first file in the navigation. The root index.md file is always the first file in the navigation. It works as the home page with it is located in the root of the `docs` folder. If you create a index.md file in a subfolder, it will be the first file in the navigation of that subfolder. + +### More Customization + +Follow the rest of the guide to build up your custom site with more advanced features and customization options. \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/manuals/Code Snippets.md b/mkdocs/docs/archive/cm.archive/manuals/Code Snippets.md new file mode 100755 index 0000000..6c998f4 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/manuals/Code Snippets.md @@ -0,0 +1,817 @@ +# Code Snippets + +Find below a list of code snippets that can be used in your projects. These are all snippets that we already use in our projects and are tested. + +## Email Button + +A simple email button that allows users to email their selected city councillor. + + +
+ + +
+ +
+ +
+
+ × +

Select Your City Councillor

+
+
+
+ + +
+ + +### Basic Email Structure +The email template is defined in the `emailCouncillor` function using two main components: +```javascript +const subject = "Constituent Feedback - [Your Issue]"; +const body = `Dear ${councillor.name}, +// ... rest of the email content +`; +``` + +### How to Modify the Template + +#### 1. Changing the Subject Line +Locate the `subject` constant in the `emailCouncillor` function: +```javascript +const subject = "Constituent Feedback - [Your Issue]"; +``` +Replace the text inside the quotes with your desired subject line. + +#### 2. Modifying the Email Body +Find the `body` template string (marked with backticks `) and modify its content: +```javascript +const body = `Dear ${councillor.name}, + +Your new email template goes here...`; +``` + +#### 3. Available Variables +The following variables are available for use in your template: +- `${councillor.name}` - Councillor's full name +- `${councillor.ward}` - Ward name +- `${councillor.title}` - Councillor's title +- `${councillor.email}` - Councillor's email address + +#### 4. Special Characters and Formatting +- Use `\n` for line breaks +- Avoid using special characters like `"` or `'` directly - escape them if needed +- Remember that HTML formatting will not work in email clients + +### Example Templates + +#### General Inquiry Template +```javascript +const subject = "General Inquiry from Constituent"; +const body = `Dear ${councillor.name}, + +I am a constituent from ${councillor.ward} seeking information about...`; +``` + +#### Specific Issue Template +```javascript +const subject = "Urgent: Traffic Safety Concern"; +const body = `Dear ${councillor.name}, + +I am writing regarding a safety concern at the intersection of...`; +``` + +#### Meeting Request Template +```javascript +const subject = "Meeting Request from ${councillor.ward} Constituent"; +const body = `Dear ${councillor.name}, + +I would like to schedule a meeting to discuss...`; +``` + +### Implementation Tips +1. Keep subject lines concise and specific +2. Include clear calls to action in the body +3. Maintain professional formatting +4. Test the template with various email clients +5. Consider mobile device compatibility + +### Technical Notes +- The template uses `encodeURIComponent()` to properly encode special characters +- Maximum email length may vary by email client +- Some email clients may have limitations on mailto link functionality + +??? "Edmonton Council Emailer Code" + ```html + +
+ + +
+ +
+ +
+
+ × +

Select Your City Councillor

+
+
+
+ + +
+ + ``` + diff --git a/mkdocs/docs/archive/cm.archive/manuals/Commands.md b/mkdocs/docs/archive/cm.archive/manuals/Commands.md new file mode 100755 index 0000000..4f342af --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/manuals/Commands.md @@ -0,0 +1,126 @@ +# Quick Link & Command System Guide + +# Using Command Functions in the Editor + +The Editor provides a set of command functions that make it easy to insert various elements into your documents. This guide will walk you through how to use these commands and how to update or add new ones. + +Commands are triggered by typing [[ and a key letter. For example, to insert a button, you would type `[[btn]]` in the editor. This will trigger the button command and prompt you to enter the button text and URL. This same fuctionality can insert files, images, and other elements into your documents. + +The available commands are defined in the `commands.js` file, where you can customize or add new commands as needed. + +This same functionality can be used in the Obsidian editor, allowing you to quickly insert elements into your documents with minimal effort. + +## Available Commands + +### Insert Button + +- **Trigger**: `btn` +- **Description**: Inserts a styled button. +- **How to Use**: + 1. Type `[[btn]]` in the editor. + 2. A prompt will appear asking for the button text and URL. + 3. Fill in the details and the button will be inserted. + +### Insert QR Code + +- **Trigger**: `qr` +- **Description**: Inserts a QR code image. +- **How to Use**: + 1. Type `[[qr]]` in the editor. + 2. A QR code will be generated and inserted at the cursor position. + +### Insert Admonition + +- **Trigger**: `adm` +- **Description**: Inserts an admonition block (e.g., note, warning). +- **How to Use**: + 1. Type `[[adm]]` in the editor. + 2. A prompt will appear asking for the type, title, and content of the admonition. + 3. Fill in the details and the admonition block will be inserted. + +### Insert Annotation + +- **Trigger**: `ann` +- **Description**: Inserts an annotation with Markdown support. +- **How to Use**: + 1. Type `[[ann]]` in the editor. + 2. A prompt will appear asking for the text to annotate and the annotation content. + 3. Fill in the details and the annotation will be inserted. + +### Insert 4-Card Grid + +- **Trigger**: `grid4` +- **Description**: Inserts a grid with 4 cards. +- **How to Use**: + 1. Type `[[grid4]]` in the editor. + 2. A prompt will appear asking for the titles and contents of the four cards. + 3. Fill in the details and the grid will be inserted. + +### Insert Blog Front Matter + +- **Trigger**: `blogfm` +- **Description**: Inserts a basic blog front matter template. +- **How to Use**: + 1. Type `[[blogfm]]` in the editor. + 2. A prompt will appear asking for the author's name. + 3. Fill in the details and the front matter will be inserted. + +## Updating Commands + +To update or add new commands, follow these steps: + +**Open the 'commands.js' File**: + - Navigate to the commands.js file in your project. + +**Add or Modify Commands**: + + - Each command is defined as an object within the `defaultCommands` array. + - To add a new command, create a new object with the following structure: + ```javascript + { + trigger: "newTrigger", + name: "New Command Name", + template: "Template for the new command", + description: "Description of the new command", + params: [ + { name: "param1", prompt: "Prompt for parameter 1" }, + { name: "param2", prompt: "Prompt for parameter 2" } + ] + } + ``` + - Example: + ```javascript + { + trigger: "example", + name: "Insert Example", + template: "Example content with $param1$ and $param2$", + description: "Inserts example content", + params: [ + { name: "param1", prompt: "Enter first parameter" }, + { name: "param2", prompt: "Enter second parameter" } + ] + } + ``` + +### **Save the File**: +Save the changes to the `commands.js` file. + +**Reload the Editor**: + + - Reload the editor to apply the changes to the command functions. + - To reload, you need to down and rebuild the docker container labeled change-maker-v[insert version #]-frontend. + - This will apply the changes to the editor and make the new commands available for use. + +**Rebuild Application**: + +If reloading editor does not push updates, you can rebuild application using `./start.sh` in the root directory. + +!!! Warning "Backup Your Data Before Rebuilding" + + Do not forget to backup your data before rebuilding the application. Critical is that you backup your listmonk data and all your customizations in the Listmonk container. Specifically ensure that your subscribers are backed up before proceeding. + +Run commands in root folder: + ``` + docker-compose down + ./start.sh + ``` \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/manuals/Customize Your Landing Page.md b/mkdocs/docs/archive/cm.archive/manuals/Customize Your Landing Page.md new file mode 100755 index 0000000..a67c358 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/manuals/Customize Your Landing Page.md @@ -0,0 +1,134 @@ +# Customize Your Landing Page +## Basic Set Up +To return to base configuration for landing page, navigate to your index.md file, and delete the properties at top of file: + +``` +// Delete this text from your index.md file +--- +title: Welcome to Bnkops Change Maker V3 +template: home.html +--- +``` + +This will allow you to write your home page in standard markdown. +## Custom Set Up +Alternatively you can edit your home pages html directly in editor. To view your front/home page html, click on the table icon next to the gear icon. Edit content and click save to upload and update landing page. +### But bnkops I don't read or write html 😧 + +**Don't panic! That is what this guide is for. Learn how to update your front page effortlessly.** +## Prompting for Updating + The code presented is standard html, which is easy to update by large language models (LLMs), often referred to as Ai. bnkops has written a [manual for creating a local llm system](https://repo.bnkops.com/Daisy%20AI%20%F0%9F%8C%BB/Daisy.html) that can do this work entirely for free. We also supply access to [Daisy](https://repo.bnkops.com/Daisy%20AI%20%F0%9F%8C%BB/Daisy.html), our own local, ethical, and custom LLM upon request. You can use any LLM to write this page; including freely accessible systems like chatgpt, claude, llama, or even whatsapp chat. + +These same techniques can be used on the site settings (accessed through the cog icon). All documentation on site options is available [here](https://squidfunk.github.io/mkdocs-material/). + +When asking an LLM to help customize your landing page, follow these key principles: + +1. **Provide Context**: Let the LLM know about the existing structure +``` +I'm using MkDocs Material theme with a custom landing page. +The template extends main.html and uses a dark theme. +I am want to fully update my landing page. +``` + +2. **Specify Requirements**: Clearly state what elements you want +``` +I need: +- A hero section with a gradient background +- Feature cards with hover effects +- Smooth scroll animations +- Custom CSS styling that matches the dark theme +``` + +3. **Reference Existing Code**: If you're modifying an existing design +``` +I'm starting with the default home.html template. Here's the current code: +[paste your current home.html content] +``` + +## Example Prompts + +### For Basic Modifications +``` +Please update my home.html template to add a new feature card section about [topic]. +Keep the existing dark theme (#1e2127) and yellow accents (#ffd700). +``` + +### For Animation Effects +``` +Add smooth scroll animations to my home.html template. I want: +- Elements to fade in as they scroll into view +- Subtle hover effects on cards +- No flashy or distracting animations +- Animations should complement the dark theme +``` + +### For Complete Redesigns +``` +Create a custom home.html template for MkDocs Material with: +1. Dark theme matching [#1e2127](http://localhost:4000/tags/1e2127) background +2. Yellow (#ffd700) accent colors +3. [List your specific sections] +4. [List your desired animations] + +Keep the template extending from main.html and ensure all styling is contained within the content block. +``` + +## Important Reminders + +- **Template Structure**: Always remind the LLM to use `{% extends "main.html" %}` and proper block structure +- **Color Scheme**: Specify the exact colors (#1e2127 for background, [#ffd700] for accents) +- **Compatibility**: Ask for self-contained CSS and JavaScript (no external dependencies) +- **Accessibility**: Request that animations respect user preferences (`prefers-reduced-motion`) + +## Example Complete Prompt + +Here's a full example of a well-structured prompt: + +``` +Please help me update my MkDocs Material landing page. I need: + +1. Template Structure: +- Extend from main.html +- Keep all CSS in a style block +- Keep JavaScript in a script block + +2. Design Requirements: +- Dark theme (#1e2127 background) +- Yellow accents (#ffd700) +- Responsive layout +- Smooth animations on scroll + +3. Specific Sections: +- Hero section with gradient +- Feature cards with hover effects +- Documentation section +- Getting started guide + +4. Animations: +- Fade-in on scroll +- Subtle hover effects +- No aggressive animations + +Please provide the complete home.html template with all necessary CSS and JavaScript included. +``` + +## Testing the Results + +After receiving the HTML: + +1. Save it to `docs/overrides/home.html`. You can do this directly in editor and click the save button to upload. You may receive a error reading; remember to reload page after saving. Error messages often will automatically resolve after a few minutes and reoload. +2. Check the template extends properly +3. Verify all styles are contained within the template +4. Test responsiveness at different screen sizes +5. Ensure animations work smoothly + +## Iterative Improvements + +If you need adjustments: + +1. Specify exactly what needs changing +2. Provide the current code +3. Describe the desired outcome +4. Ask for specific sections to be updated + +Remember: LLMs can be creative with designs while maintaining your core requirements. Be specific about what must be preserved (like color schemes and structure) but allow flexibility for creative elements. \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/manuals/Examples.md b/mkdocs/docs/archive/cm.archive/manuals/Examples.md new file mode 100755 index 0000000..9f9a88d --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/manuals/Examples.md @@ -0,0 +1,812 @@ +# Example Political Apps +In addition to Change Maker, bnkops has already completed development on plugins for newsletters, email targeting, and micro sites. These technologies are also highly customizable, free to deploy, and actively maintained by bnkops. + +bnkops will bake these plugins directly into the installation process for Change Maker (V4 here we come). For now, manuals for installation, hosting, and deployment can be found at [repo.bnkops.com](https://repo.bnkops.com/Free%20Office%20Software%20Stack%20%F0%9F%A4%AF/The%20Bunker%20Ops%20Server%20Build-Out.html). + +# Email Button + +Insert a counter button to email local council members in Edmonton. Example: + + +
+ + +
+ +
0 emails sent
+
+ +
+
+ × +

Select Your City Councillor

+
+
+
+ + +
+ + +[See Code Snippets For More](Code Snippets.md){ .md-button } + +# Embed Any iframe +Any iframe embedding will work and render on site allowing for adding audio/visuals from thousands of different sources. For example: + + + + + + +
+
🎼
+
🎡
+ +
+ +
+ +
+ 🎡 + The revolution will be sung before it is written + ✨ +
+
+ + + + + +## Newsletter +bnkops uses [listmonk](https://listmonk.app/) for its newsletter management. An example deployment: + + + + + + +
+

+ πŸ“« + Subscribe for Updates +

+ +
+ + +
+ + +
+ +
+ + +
+ +
+ + +
+ + +
+
+ + + +## Simple Target +Simple Target is a bnkops app that facilitates a email campaign pointed at a inbox. These can be embedded with ease. + + \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/manuals/Get Site Online.md b/mkdocs/docs/archive/cm.archive/manuals/Get Site Online.md new file mode 100755 index 0000000..1b06b4b --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/manuals/Get Site Online.md @@ -0,0 +1,292 @@ +# Get Online + +!!! note "Update" + Change Maker V3 online access requires customized deployment package. Change Maker V4 will include a automated process for getting online. If wanting to deploy asap email [admin@thebunkerops.ca](mailto:admin@thebunkerops.ca) for partnership opportunities or follow manual. + + This guide will help you get your site online quickly and easily. By following these steps, you can have your site up and running in no time. We are recommending the service that we use to get online, which is Cloudflare. There are dozens of ways to host your site and application online. This guide will walk you through the process of setting up Cloudflare Tunnel to get your site online. + + [Cloudflare](https://www.cloudflare.com/){ .md-button } + +### Alternatives to Cloudflare Tunnels + +If Cloudflare Tunnels don't meet your needs, here are some other options to consider: + +**NGINX Reverse Proxy** + + - Use NGINX to route traffic to your local server. + - Provides load balancing, SSL termination, and caching. + +**Apache Reverse Proxy** + + - Similar to NGINX, but uses Apache HTTP Server. + - Offers extensive configuration options and modules. + +**Localtunnel** + + - Quickly expose your local server to the internet. + - Easy to set up with minimal configuration. + +**Ngrok** + + - Provides secure introspectable tunnels to localhost. + - Offers additional features like custom subdomains and webhooks. + +**Serveo** + + - Another tool to expose local servers to the internet. + - No installation required, works over SSH. + +Each of these alternatives has its own set of features and benefits, so you can choose the one that best fits your requirements. + +### What is [Cloudflare?](https://www.cloudflare.com/) + +[Cloudflared Docmentation](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/get-started/){ .md-button } + +Cloudflare is a service that provides a range of features to improve the security, performance, and reliability of your website. It acts as a reverse proxy between your website visitors and your web hosting provider. Why we use Cloudlfare: + +- **Security**: Protects your site from malicious attacks, including DDoS attacks, by filtering traffic before it reaches your server. +- **Performance**: Speeds up your website by caching content and serving it from data centers around the world. +- **Reliability**: Ensures your site remains available even if your server goes down by using its global network to keep your site online. + +The Cloudflare backend and admin tools are also quite powerfull; allowing you to manage your site, monitor traffic, and configure security settings all in one spot. We quite enjoy the free analytics that are not pervasive trackers; just simple info about where people are visiting your site from. + +### Before You Start +- You need a domain name (like yoursite.com) +- Your domain should be using Cloudflare (they have a free plan) +- Make sure Change Maker is working on your computer first + +### Installing Cloudflare Tunnel + +1. **Download Cloudflared** + - Windows: Download the latest release from [https://github.com/cloudflare/cloudflared/releases](https://github.com/cloudflare/cloudflared/releases) + - Mac: `brew install cloudflare/cloudflare/cloudflared` + - Linux: + ```bash + curl -L --output cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb + sudo dpkg -i cloudflared.deb + ``` + +2. **Login to Cloudflare** + ```bash + cloudflared tunnel login + ``` + Follow the browser prompts to authenticate. + +### Setting Up Your Tunnel + +**Create the Tunnel** + + - Open Terminal (Command Prompt on Windows) + - Type: `cloudflared tunnel create change-maker-site` + - Copy the Tunnel ID it gives you (you'll need this) + +**Create the Settings File** + + - On Windows, create this folder: `C:\Users\YOUR-USERNAME\.cloudflared` + - On Mac/Linux, it's in: `~/.cloudflared` + - Create a file called `config-site.yml` in that folder + - Open it with Notepad (Windows) or any text editor + +**Add These Settings** + ```yaml + tunnel: YOUR-TUNNEL-ID + credentials-file: ~/.cloudflared/YOUR-TUNNEL-ID.json + ingress: + - hostname: yoursite.com + service: http://localhost:4000 + - hostname: button.yoursite.com + service: http://localhost:5001 + - hostname: cmeditor.yoursite.com + service: http://localhost:3000 + - hostname: listmonk.yoursite.com + service: http://localhost:9000 + - service: http_status:404 + ``` + Replace: + - `YOUR-TUNNEL-ID` with the ID from step 1 + - `yoursite.com` with your actual website address + +**Connect to Cloudflare** + + - Go to cloudflare.com and log in + - Click on your domain + - Click "DNS" + - Add a new record: + - Type: CNAME + - Name: @ (or leave blank) + - Target: YOUR-TUNNEL-ID.cfargotunnel.com + - Proxy status: Proxied (orange cloud) + +## Secure Site + +If you are publically serving your site, it is recommended to secure your cmeditor and listmonk sites. This can be done by setting up Cloudflare Access. + +[Cloudlfare Access](https://developers.cloudflare.com/cloudflare-one/applications/configure-apps/self-hosted-apps/){ .md-button } + +### Starting Your Tunnel + +!!! Warning "Secure Your CMeditor" + Make sure your CMEditor is secure and only accessible by you. Access to the system backend can be a security risk. + +#### Method 1: Running Manually (Easiest to Start With) + +1. **Start the Tunnel** + - Open Terminal/Command Prompt + - Type: `cloudflared tunnel --config ~/.cloudflared/config-site.yml run` + - Leave this window open + +#### Method 2: Running as Background Services (More Advanced) + +On Windows: +```cmd +cloudflared service install --config C:\Users\YOUR-USERNAME\.cloudflared\config-site.yml +``` + +On Mac/Linux: +```bash +sudo cloudflared service install --config ~/.cloudflared/config-site.yml +``` + +### Checking If Everything Works + +1. Start Change Maker: + ```bash + docker compose down + docker system prune -f + docker compose up --build + ``` + +2. Make sure your tunnels are running (you should see messages in those windows) + +3. Try visiting your sites: + + - Main website: `https://yoursite.com` + - Editor: `https://cmeditor.yoursite.com` + - Listmonk: `https://listmonk.yoursite.com` + + +## Making Changes Manually (if needed) + +If you need to change things by hand, here's what to do: + +### 1. Change Your Website Address +Open these files and update the website address: + +In `mkdocs.yml`: +```yaml +site_name: Your Site Name +site_url: https://yoursite.com/ +``` + +In `docker-compose.yml`: +```yaml +# Look for lines with: +SITE_URL=https://yoursite.com +``` + +In `constants.js`: +```javascript +export const MKDOCS_URL = 'https://yoursite.com'; +``` + +### 2. Change Editor Address +Look for `cmeditor.yoursite.com` in these files: +- `docker-compose.yml` +- `constants.js` +- `server.js` + +## Troubleshooting + +### Common Problems and Solutions + + **"Something's already using that port"** + + - Change the port numbers in the setup + - Or close other programs that might be using those ports + +**"Can't connect to the website"** + + - Make sure Change Maker is running + - Check that your Cloudflare tunnels are running + - Try opening the site on your computer first (localhost) + +**"Editor won't save changes"** + + - Check that all addresses match in your setup + - Make sure you're using https:// for web addresses + - Restart Change Maker if needed + +### Common Tunnel Problems + +**"Tunnel Not Connected"** + + - Check that both tunnel windows are still open + - Make sure you see "connected" messages + - Try running the tunnel command again + +**"Can't Find Certificate"** + + - Your settings files might be in the wrong place + - Double-check the folder names and locations + - Run `cloudflared tunnel login` and try again + +**"Wrong Address"** + + - Make sure all your domain names match exactly + - Check Cloudflare DNS settings + - Look for typos in config files + +**"Editor Not Working"** + + - Make sure both tunnels are running + - Check that Change Maker is running + - Verify all your addresses match in the files we changed earlier + +### Keeping Your Editor Private (Recommended) + +1. Go to Cloudflare Zero Trust +2. Create an Access Policy: + - Click "Applications" + - Add new application + - Choose "Self-hosted" + - Enter `https://cmeditor.yoursite.com` + - Add your email under "Allowed Users" +3. Now only you can access the editor + +### Need Help? + +If things aren't working: +1. Check that Change Maker is running +2. Make sure your tunnels are running +3. Look for error messages in the terminal windows +4. Try restarting everything + +### Safety Tips + +1. Keep your editor address private +2. Use strong passwords +3. Regular backups are a good idea +4. Keep your computer's security up to date + +## Backup Your Work + +### Quick Backup +- Find your Change Maker folder +- Copy the whole `docs` folder somewhere safe +- That's your content backed up! + +### Restore from Backup +- Just copy your backed-up `docs` folder back +- Restart Change Maker +- Your content should be back + +## After Setup + +Remember to: + +1. Keep the program running when you want your site available +2. Make regular backups of your content +3. Keep your domain and Cloudflare account active +4. Update your software regularly + +Need more help? Check the technical manual for detailed instructions or ask in the community forums. \ No newline at end of file diff --git a/mkdocs/docs/archive/cm.archive/manuals/backlinks.png b/mkdocs/docs/archive/cm.archive/manuals/backlinks.png new file mode 100755 index 0000000..12dc988 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/backlinks.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/button.md b/mkdocs/docs/archive/cm.archive/manuals/button.md new file mode 100755 index 0000000..5163f54 --- /dev/null +++ b/mkdocs/docs/archive/cm.archive/manuals/button.md @@ -0,0 +1,409 @@ +# Change Maker Simple Button + +
+

+ Transform any website into a powerful catalyst for change with our seamless, one-click solution. +

+

+ Free. Open. Built by activists, for activists. +

+
+ + + +
+
+

Simple Button

+ +

Empower your community with zero technical hassle.

+ +
+
+
πŸ“§
+
+

Direct Impact

+

Real emails that work

+
+
+
+
⚑
+
+

Instant Setup

+

From idea to action in minutes

+
+
+
+
πŸ”’
+
+

Privacy First

+

Your data stays yours

+
+
+
+
πŸ’
+
+

Always Free

+

No hidden costs

+
+
+
+
🀝
+
+

Community Built

+

By organizers, for organizers

+
+
+
+
🌐
+
+

Instant Pages

+

Built-in landing pages

+
+
+
+
πŸ”Œ
+
+

Embed Anywhere

+

Works on any website

+
+
+
+
πŸ›Ÿ
+
+

Ongoing Support

+

Community backed help

+
+
+
+
πŸ‘©β€πŸ’»
+
+

Open Code

+

Transparent & secure

+
+
+
+
+ +
+

Live Demo

+ +
+
+ +## Why Use Simple Change Button? + +- ✨ **Free Forever** - No hidden costs, no premium features +- πŸš€ **5-Minute Setup** - From zero to action in minutes +- πŸ“§ **Real Impact** - Emails come from real people's accounts +- πŸ”’ **Privacy First** - No invasive tracking of users +- πŸ’ͺ **Community Owned** - Built by organizers, for organizers + +Install Simple Change Button on your website and start making a difference today! + +## Installation Guide + +Simple Change Button is a self-hosted tool that requires Docker & Docker Compose to run. Follow these steps to get started: + +Install Docker & Docker Composer + +[Docker Installation Instructions](Installation.md){ .md-button } + +Releases of the latest version of Simple Change Button are released with the newsletter. To get the latest version, subscribe to the newsletter below: + +
+
+ +

Subscribe

+ +
+

+ +

+

+ +

+
+ +

+ + +

+ +

+ +

+
+
+ +Or you can email the admin directly and request access: + +
+ +
+ +## Install + +### Independent Installation + +#### Download and Unzip the Latest Release + +#### Update .env Files + +In the Simple Change Button directory, update the `.env` files with your desired settings. Theese two files can be found in the `backend` and `frontend` directories. + +!!! example ".frontend/.env" + ``` + REACT_APP_API_URL=http://localhost:5000 + REACT_APP_PRODUCTION_URL=https://button.bnkops.com // Change this to your domain + NODE_ENV=development // change to production for production + PORT=5001 + ``` + + +!!! example ".backend/.env" + ``` + JWT_SECRET=your-very-secure-and-very-long-secret-key-here // Change this to a secure key + MONGODB_URI=mongodb://127.0.0.1:27017/emailcounter + PORT=5000 + NODE_ENV=development // change to production for production + CORS_ORIGIN=http://localhost:5001 + ``` + +Run `docker-compose up` in the Simple Change Button directory. + +Your Simple Change Button instance will be available at `http://localhost:5001` in your browser. + +### Install With Changemaker + +If you are using Changemaker, you can install Simple Change Button during installation. + +Run `./start.sh` in the root directory and select Simple Change Button from the list of available tools. + +## First Open + +On first open, you will be prompted to create an admin account. Fill in the details and click "Create Account". You will then be redirected to the dashboard. + +### Quick Start + +1. Create a button in the dashboard +2. Copy the embed code +3. Paste it anywhere on your site +4. Track real engagement + +## Dashboard + +![alt text](image-21.png) + +The dashboard is where you can create, manage, and track your buttons. You can also manage users and view statistics. + +### Dashboard Features + +- Total emails sent +- Per-button metrics +- Usage trends +- Real-time statistics +- Export capabilities +- User Management + +## Analytics + +![alt text](image-23.png) + +Analytics are available in real-time and provide insights into button performance. You can also export data for further analysis. + +## User Management + +![alt text](image-24.png) + +User management allows you to add, remove, and edit user accounts. Future updates will include assign roles and permissions to users. + +## Creating a Button + +![alt text](image-22.png) + +1. Log into admin dashboard +2. Click "Create New Button" +3. Fill in button details +4. Optional: Add CC/BCC +5. Save and get embed code + +## Editing a Button + +![alt text](image-25.png) + +Buttons are listed according to time of creation and can be edited at any time. You can change the button text, email body, and other settings. + +## Standalone Button Page + +![alt text](image-26.png) + +All buttons also generate a standalone page that can be shared directly. This page includes the button, email body, and other details. Useful for sharing on social media or in emails. + +## Privacy & Security + +- No personal data collection +- GDPR-compliant design +- Encrypted connections +- Local data storage only + +## Deployment + +Bnkops uses Cloudflare for secure, fast, and reliable hosting. You can also deploy Simple Change Button on your own server. + +We have instructions for deployment through Cloudflare for the whole Changemaker suite. + +[Cloudflare Deployment](Get Site Online.md){ .md-button } + +However, you can also deploy Simple Change Button independently. Here is a sample configuration file for Cloudflare Tunnel: + +!!! example "Cloudflare Tunnel Configuration" + ```yaml + tunnel: [YOUR-TUNNEL-ID] + credentials-file: [path-to-credentials-file] + ingress: + - hostname: [button.your-domain.com] + service: http://localhost:5001 + - service: http_status:404 + ``` + +## Best Practices + +!!! tip "Design Recommendations" + + - Keep email body concise + - Use clear call-to-action text + - Test buttons before deployment + - Monitor performance regularly + +## Troubleshooting + +!!! question "Common Issues" + **Button not tracking:** + + - Check internet connection + - Verify proper embedding + - Clear browser cache + + **Stats not updating:** + + - Refresh dashboard + - Check server connection + - Verify permissions + +## Support + +Contact system administrator for: + +- Technical issues +- Feature requests +- Account problems +- General assistance + +--- +Built with β™₯️ by communities, for communities + + + diff --git a/mkdocs/docs/archive/cm.archive/manuals/files2.png b/mkdocs/docs/archive/cm.archive/manuals/files2.png new file mode 100755 index 0000000..d2abc43 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/files2.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-1.png b/mkdocs/docs/archive/cm.archive/manuals/image-1.png new file mode 100755 index 0000000..f6bf95c Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-1.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-10.png b/mkdocs/docs/archive/cm.archive/manuals/image-10.png new file mode 100755 index 0000000..acaf925 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-10.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-11.png b/mkdocs/docs/archive/cm.archive/manuals/image-11.png new file mode 100755 index 0000000..0a91f8f Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-11.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-12.png b/mkdocs/docs/archive/cm.archive/manuals/image-12.png new file mode 100755 index 0000000..e049cf3 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-12.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-13.png b/mkdocs/docs/archive/cm.archive/manuals/image-13.png new file mode 100755 index 0000000..18deabb Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-13.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-14.png b/mkdocs/docs/archive/cm.archive/manuals/image-14.png new file mode 100755 index 0000000..55ced48 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-14.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-15.png b/mkdocs/docs/archive/cm.archive/manuals/image-15.png new file mode 100755 index 0000000..55ced48 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-15.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-16.png b/mkdocs/docs/archive/cm.archive/manuals/image-16.png new file mode 100755 index 0000000..55ced48 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-16.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-17.png b/mkdocs/docs/archive/cm.archive/manuals/image-17.png new file mode 100755 index 0000000..94fbd63 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-17.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-18.png b/mkdocs/docs/archive/cm.archive/manuals/image-18.png new file mode 100755 index 0000000..94fbd63 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-18.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-19.png b/mkdocs/docs/archive/cm.archive/manuals/image-19.png new file mode 100755 index 0000000..2c701c2 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-19.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-2.png b/mkdocs/docs/archive/cm.archive/manuals/image-2.png new file mode 100755 index 0000000..0d3c48b Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-2.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-20.png b/mkdocs/docs/archive/cm.archive/manuals/image-20.png new file mode 100755 index 0000000..75ea0d6 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-20.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-21.png b/mkdocs/docs/archive/cm.archive/manuals/image-21.png new file mode 100755 index 0000000..274b931 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-21.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-22.png b/mkdocs/docs/archive/cm.archive/manuals/image-22.png new file mode 100755 index 0000000..83ca81e Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-22.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-23.png b/mkdocs/docs/archive/cm.archive/manuals/image-23.png new file mode 100755 index 0000000..6ae8e53 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-23.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-24.png b/mkdocs/docs/archive/cm.archive/manuals/image-24.png new file mode 100755 index 0000000..c241fb3 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-24.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-25.png b/mkdocs/docs/archive/cm.archive/manuals/image-25.png new file mode 100755 index 0000000..1f729dd Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-25.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-26.png b/mkdocs/docs/archive/cm.archive/manuals/image-26.png new file mode 100755 index 0000000..fc301f7 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-26.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-3.png b/mkdocs/docs/archive/cm.archive/manuals/image-3.png new file mode 100755 index 0000000..4ce4b46 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-3.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-4.png b/mkdocs/docs/archive/cm.archive/manuals/image-4.png new file mode 100755 index 0000000..4f8ceef Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-4.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-5.png b/mkdocs/docs/archive/cm.archive/manuals/image-5.png new file mode 100755 index 0000000..38befa0 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-5.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-6.png b/mkdocs/docs/archive/cm.archive/manuals/image-6.png new file mode 100755 index 0000000..2d878a6 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-6.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-7.png b/mkdocs/docs/archive/cm.archive/manuals/image-7.png new file mode 100755 index 0000000..660d55b Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-7.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-8.png b/mkdocs/docs/archive/cm.archive/manuals/image-8.png new file mode 100755 index 0000000..2d6e162 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-8.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image-9.png b/mkdocs/docs/archive/cm.archive/manuals/image-9.png new file mode 100755 index 0000000..4a7c846 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image-9.png differ diff --git a/mkdocs/docs/archive/cm.archive/manuals/image.png b/mkdocs/docs/archive/cm.archive/manuals/image.png new file mode 100755 index 0000000..de254e0 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/manuals/image.png differ diff --git a/mkdocs/docs/archive/cm.archive/mkdocs.png b/mkdocs/docs/archive/cm.archive/mkdocs.png new file mode 100644 index 0000000..0601662 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/mkdocs.png differ diff --git a/mkdocs/docs/archive/cm.archive/settings.png b/mkdocs/docs/archive/cm.archive/settings.png new file mode 100644 index 0000000..2b06ab1 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/settings.png differ diff --git a/mkdocs/docs/archive/cm.archive/thumbsup.gif b/mkdocs/docs/archive/cm.archive/thumbsup.gif new file mode 100644 index 0000000..63c5ae6 Binary files /dev/null and b/mkdocs/docs/archive/cm.archive/thumbsup.gif differ diff --git a/mkdocs/docs/archive/index.md b/mkdocs/docs/archive/index.md new file mode 100644 index 0000000..13daccf --- /dev/null +++ b/mkdocs/docs/archive/index.md @@ -0,0 +1,6 @@ +# Archive + +The following is content for the archive. + +It is highly likely that a lot of links will be broken in this page, so please check it carefully! +