Compare commits

..

6 Commits

202 changed files with 2320 additions and 193 deletions

View File

@ -1,5 +1,22 @@
# Changelog
## 2025-02-16 - 1.2.1 - fix(core)
No changes detected in the current files.
## 2025-02-16 - 1.2.0 - feat(vitepress-config)
Add support for downloading and organizing additional documentation from external sources
- Integrated new functionality to download readmes for 'social.io' and organize them in the documentation structure.
- Updated navigation to include new links for 'social.io' docs.
## 2025-01-25 - 1.1.0 - feat(docs)
Add integration for downloading and incorporating readme documents from external domains
- Extended functionality in docs/.vitepress/config.ts to download and integrate README documents into documentation.
- Introduced new README files for several projects under the docs/push.rocks/ directory.
- Expanded project capabilities by integrating content from 'serve.zone' with update in README structures.
## 2025-01-25 - 1.0.10 - fix(docs)
Updated handlebars template documentation and fixed repository process filtering.

View File

@ -29,6 +29,18 @@ export default async () => {
plugins.path.join(paths.docsDir, 'push.rocks'),
);
await helpers.downloadReadmes(
'https://code.foss.global',
'serve.zone',
plugins.path.join(paths.docsDir, 'serve.zone'),
);
await helpers.downloadReadmes(
'https://code.foss.global',
'social.io',
plugins.path.join(paths.docsDir, 'social.io'),
);
return plugins.vitepress.defineConfig({
lang: 'en-US',
@ -74,6 +86,11 @@ export default async () => {
items: await helpers.generateNavLinks('serve.zone'),
collapsed: true,
},
{
text: 'social.io',
items: await helpers.generateNavLinks('social.io'),
collapsed: true,
},
],
},
],

View File

@ -50,6 +50,38 @@ export async function downloadReadmes(
): Promise<void> {
// Ensure the output directory exists
await plugins.fs.mkdir(outputDir, { recursive: true });
/**
* Reads all existing .md files in the specified directory and deletes any
* whose frontmatter has `source === "gitea"`.
*/
async function removeGiteaSourceFiles(dirPath: string): Promise<void> {
try {
const existingFiles = await plugins.fs.readdir(dirPath);
for (const file of existingFiles) {
if (file.endsWith('.md')) {
const filePath = plugins.path.join(dirPath, file);
const fileContent = await plugins.fs.readFile(filePath, 'utf8');
// Parse frontmatter
const smartfmInstance = new plugins.smartfm.Smartfm({
fmType: 'yaml'
});
const frontmatter = smartfmInstance.parse(fileContent);
// If `source` is "gitea", delete this file
if (frontmatter.data && frontmatter.data.source === 'gitea') {
await plugins.fs.rm(filePath);
console.log(`Deleted file with frontmatter source === "gitea": ${filePath}`);
}
}
}
} catch (error) {
console.error('Error removing files with gitea source frontmatter:', error);
}
}
// Call the function to remove existing .md files with frontmatter source === "gitea"
await removeGiteaSourceFiles(outputDir);
// Helper function to construct headers
const getHeaders = (additionalHeaders: Record<string, string> = {}) => {
@ -139,6 +171,7 @@ export async function downloadReadmes(
let readmeContent = atob(readmeContentResponseObject.content);
readmeContent = `---
title: "@${org}/${repo.name}"
source: "gitea"
---
${readmeContent}`;
const sanitizedRepoName = repoName.replace(/[^a-z0-9_\-]/gi, '_'); // Sanitize filename

View File

@ -1,5 +1,6 @@
---
title: "@api.global/docs"
source: "gitea"
---
# @apiglobal/private/docs
Open Source headless CMS

View File

@ -1,5 +1,6 @@
---
title: "@api.global/sdk"
source: "gitea"
---
# @api.global/sdk

View File

@ -1,5 +1,6 @@
---
title: "@api.global/test-sdk"
source: "gitea"
---
# @api.global/test-sdk
an sdk for testing ag handlers

View File

@ -1,5 +1,6 @@
---
title: "@api.global/typedelectron"
source: "gitea"
---
# @api.global/typedelectron

View File

@ -1,5 +1,6 @@
---
title: "@api.global/typedrequest-interfaces"
source: "gitea"
---
# @api.global/typedrequest-interfaces

View File

@ -1,5 +1,6 @@
---
title: "@api.global/typedrequest"
source: "gitea"
---
# @api.global/typedrequest

View File

@ -1,5 +1,6 @@
---
title: "@api.global/typedserver"
source: "gitea"
---
```markdown
# @api.global/typedserver

View File

@ -1,5 +1,6 @@
---
title: "@api.global/typedsocket"
source: "gitea"
---
# @api.global/typedsocket
a typedrequest extension supporting websockets

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/abuse.ch"
source: "gitea"
---
# @apiclient.xyz/abuse.ch
an unofficial client to retrieve abuse.ch data

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/bobcat"
source: "gitea"
---
# @mojoio/bobcat
a module to talk to bobcat miners

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/bunq"
source: "gitea"
---
# @mojoio/bunq
a bunq api abstraction package

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/cloudflare"
source: "gitea"
---
# @apiclient.xyz/cloudflare
easy cloudflare management

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/datev"
source: "gitea"
---
# @mojoio/datev
an unofficial api client for the datev connect online xml api

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/docker"
source: "gitea"
---
# @apiclient.xyz/docker

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/elasticsearch"
source: "gitea"
---
# @mojoio/elasticsearch
log to elasticsearch in a kibana compatible format

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/ghost"
source: "gitea"
---
# @apiclient.xyz/ghost
An unofficial Ghost API package

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/gitlab"
source: "gitea"
---
# @mojoio/gitlab
a gitlab api abstraction package

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/helium"
source: "gitea"
---
# @mojoio/helium
a helium api package

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/hetznercloud"
source: "gitea"
---
# @apiclient.xyz/hetznercloud
An unofficial API client for the Hetzner Cloud API

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/kubernetes"
source: "gitea"
---
# @mojoio/kubernetes
a simmplified kubernetes api abstraction

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/letterxpress"
source: "gitea"
---
# @mojoio/letterxpress
an unofficial API package for the letterxpress API

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/lexoffice"
source: "gitea"
---
# @mojoio/lexoffice
an unofficial api client for lexoffice

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/logdna"
source: "gitea"
---
# @mojoio/logdna
an unoffical package for the logdna api

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/logtail"
source: "gitea"
---
# @mojoio/logtail
an unofficial api abstraction package for logtail.com taolored to the smartlog ecosystem

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/mailgun"
source: "gitea"
---
# @mojoio/mailgun
an api abstraction package for mailgun

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/medium"
source: "gitea"
---
# @apiclient.xyz/medium

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/ora"
source: "gitea"
---
# @mojoio/ora
an api abstraction package for ora.pm

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/paddle"
source: "gitea"
---
# @mojoio/paddle
an unofficial paddle API package

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/paypal"
source: "gitea"
---
# @mojoio/paypal
an unofficial paypal API package

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/sentry"
source: "gitea"
---
# @mojoio/sentry
an unofficial abstraction package for sentry.io

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/slack"
source: "gitea"
---
# @mojoio/slack
slack api abstraction for the mojo.io ecosystem

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/tink"
source: "gitea"
---
# @apiclient.xyz/tink
an unofficial api abstraction for tink.com

View File

@ -1,5 +1,6 @@
---
title: "@apiclient.xyz/zitadel"
source: "gitea"
---
# @apiclient.xyz/zitadel

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/dees-catalog"
source: "gitea"
---
# @design.estate/dees-catalog
An extensive library for building modern web applications with dynamic components using Web Components, JavaScript, and TypeScript.

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/dees-comms"
source: "gitea"
---
# @design.estate/dees-comms
a comms module for communicating within the DOM

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/dees-document"
source: "gitea"
---
# @design.estate/dees-document

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/dees-domtools"
source: "gitea"
---
# @design.estate/dees-domtools
tools to simplify complex css structures

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/dees-editor"
source: "gitea"
---
# @design.estate/dees-editor
an advanced editor for markdown documents based on monaco.

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/dees-element"
source: "gitea"
---
# @design.estate/dees-element
a custom element class extending lit element class

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/dees-wcctools"
source: "gitea"
---
# @design.estate/dees-wcctools
wcc tools for creating element catalogues

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/fontloader"
source: "gitea"
---
# @designestate/fontloader
a fontloader for managing font loading from A to Z

View File

@ -1,5 +1,6 @@
---
title: "@design.estate/navigation"
source: "gitea"
---
# @designestate/navigation
A module for opinionated navigation abstraction.

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/beautyfiglet"
source: "gitea"
---
# @push.rocks/beautyfiglet
A Node.js module that facilitates the creation of ASCII art using figlet with customizable fonts and layouts.

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/commitinfo"
source: "gitea"
---
# @push.rocks/commitinfo
bake commitinfos into code

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/consolecolor"
source: "gitea"
---
# @push.rocks/consolecolor

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/early"
source: "gitea"
---
# @push.rocks/early
minimal and fast loading plugin for startup time measuring

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/gulp-function"
source: "gitea"
---
# @push.rocks/gulp-function

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/isohash"
source: "gitea"
---
# @push.rocks/isohash
a hash package that works cross environment

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/isotransport"
source: "gitea"
---
# @push.rocks/isotransport
a bi-directional, multiplatform, best-effort transport

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/levelcache"
source: "gitea"
---
# @push.rocks/levelcache
A cache that utilizes memory, disk, and S3 for data storage and backup.

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/lik"
source: "gitea"
---
# @push.rocks/lik
light little helpers for node

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/metadoc"
source: "gitea"
---
# @push.rocks/metadoc
a metadoc module for progressivly enhancing documents

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/mongodump"
source: "gitea"
---
# @push.rocks/mongodump
a tool to handle dumps of MongoDB databases

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/npmextra"
source: "gitea"
---
# @push.rocks/npmextra
A utility to enhance npm with additional configuration, tool management capabilities, and a key-value store for project setups.

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/projectinfo"
source: "gitea"
---
# @push.rocks/projectinfo

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/qenv"
source: "gitea"
---
# @push.rocks/qenv
easy promised environments

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/searchquery"
source: "gitea"
---
# @push.rocks/searchquery
a module for dealing with searchqueries

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartacme"
source: "gitea"
---
```markdown
# @push.rocks/smartacme

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartaction"
source: "gitea"
---
# @push.rocks/smartaction
a module for managing actions. What was done? What needs to be done? How often should it be done? What's currently being done?

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartai"
source: "gitea"
---
# @push.rocks/smartai

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartantivirus"
source: "gitea"
---
# @push.rocks/smartantivirus

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartarchive"
source: "gitea"
---
# @push.rocks/smartarchive

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartarray"
source: "gitea"
---
# @push.rocks/smartarray

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartbrowser"
source: "gitea"
---
# @push.rocks/smartbrowser
simplified puppeteer

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartbucket"
source: "gitea"
---
```markdown
# @push.rocks/smartbucket

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartbuffer"
source: "gitea"
---
Given the context and limitations, a realistic expansion to cover the 4000 words requirement with detailed usage scenarios and advanced examples for the `@push.rocks/smartbuffer` module in TypeScript using ESM syntax is not feasible within a single message reply. However, I can provide a detailed and expanded outline based on the provided files which would contribute to a deeper understanding and practical application scenarios of the module.

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartcache"
source: "gitea"
---
# @push.rocks/smartcache
Cache things in smart ways.

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartchok"
source: "gitea"
---
# @push.rocks/smartchok
smart wrapper for chokidar

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartcli"
source: "gitea"
---
# @push.rocks/smartcli

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartclickhouse"
source: "gitea"
---
# @push.rocks/smartclickhouse

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartcls"
source: "gitea"
---
# @push.rocks/smartcls

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartcontext"
source: "gitea"
---
# @push.rocks/smartcontext

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartcrypto"
source: "gitea"
---
# @push.rocks/smartcrypto
easy crypto methods

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartcsv"
source: "gitea"
---
# @push.rocks/smartcsv
handle csv data | gitzone standard compliant

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdaemon"
source: "gitea"
---
# @push.rocks/smartdaemon
start scripts as long running daemons and manage them

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdata"
source: "gitea"
---
# @push.rocks/smartdata
do more with data

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdebug"
source: "gitea"
---
# smartdebug

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdelay"
source: "gitea"
---
# @push.rocks/smartdelay

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdeno"
source: "gitea"
---
# @push.rocks/smartdeno
a module to run deno from node

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdiff"
source: "gitea"
---
# @push.rocks/smartdiff
a diffing lib for text

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdns"
source: "gitea"
---
# @push.rocks/smartdns
A TypeScript library for smart DNS methods, supporting various DNS records and providers.

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdocumentation"
source: "gitea"
---
# @push.rocks/smartdocumentation
a tool for mapping git directories to documentation sites

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartdrive"
source: "gitea"
---
# @push.rocks/smartdrive
do more with local and cloud drives

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartenv"
source: "gitea"
---
# @push.rocks/smartenv

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartevent"
source: "gitea"
---
# @push.rocks/smartevent
handle events in smart ways

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartexit"
source: "gitea"
---
# @push.rocks/smartexit

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartexpect"
source: "gitea"
---
# @push.rocks/smartexpect
manage expectations in code

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartexpose"
source: "gitea"
---
# @push.rocks/smartexpose
a package to expose things to the internet

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartfeed"
source: "gitea"
---
# @push.rocks/smartfeed
create and parse feeds

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartfile-interfaces"
source: "gitea"
---
# @push.rocks/smartfile-interfaces

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartfile"
source: "gitea"
---
# @push.rocks/smartfile

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartfm"
source: "gitea"
---
# @push.rocks/smartfm

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartformat"
source: "gitea"
---
# @push.rocks/smartformat

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartfuzzy"
source: "gitea"
---
# @push.rocks/smartfuzzy

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartgit"
source: "gitea"
---
# @push.rocks/smartgit
smart wrapper for nodegit

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartguard"
source: "gitea"
---
# @push.rocks/smartguard
A TypeScript library for creating and managing validation guards, aiding in data validation and security checks.

View File

@ -1,5 +1,6 @@
---
title: "@push.rocks/smartgulp"
source: "gitea"
---
# @push.rocks/smartgulp
lightweight gulp replacement

Some files were not shown because too many files have changed in this diff Show More