@md-plugins/quasar-app-extension-q-press 0.1.0-alpha.10

package/src/templates/init/src/components/LandingPage/LandingPage.vue

@@ -0,0 +1,341 @@
+<template>
+  <div class="landing-page markdown-brand">
+    <header class="hero">
+      <img
+        src="https://raw.githubusercontent.com/md-plugins/md-plugins/refs/heads/main/media/markdown-1024x1024.png"
+        alt="Markdown Plugins Logo"
+        class="hero-logo"
+      />
+      <h1 class="hero-title">Markdown Plugins</h1>
+      <h2 class="hero-subtitle">(@md-plugins)</h2>
+      <div class="row justify-center">
+        <p class="hero-subtitle2" style="max-width: 660px">
+          {{ siteConfig.description }}
+        </p>
+      </div>
+
+      <div class="hero-buttons">
+        <router-link
+          to="/getting-started/introduction"
+          class="hero-button q-btn q-btn-item non-selectable no-outline q-btn--standard q-btn--rectangle q-btn--actionable q-focusable q-hoverable q-btn--no-uppercase q-btn--rounded q-btn--dense"
+        >
+          <span
+            class="q-btn__content text-center col items-center q-anchor--skip justify-center row"
+          >
+            Get Started
+          </span>
+        </router-link>
+        <a
+          href="https://github.com/md-plugins/md-plugins"
+          target="_blank"
+          class="hero-button q-btn q-btn-item non-selectable no-outline q-btn--standard q-btn--rectangle q-btn--actionable q-focusable q-hoverable q-btn--no-uppercase q-btn--rounded q-btn--dense"
+        >
+          <span
+            class="q-btn__content text-center col items-center q-anchor--skip justify-center row"
+          >
+            <q-icon :name="fabGithub" class="q-mr-sm" />
+            GitHub Repo
+          </span>
+        </a>
+      </div>
+    </header>
+    <div class="byline">
+      <p>Discover the power of Markdown Plugins and enhance your documentation experience!</p>
+      <p>
+        <strong>NOTE:</strong> MD-Plugins are currently in development and not suitable for
+        production.
+      </p>
+    </div>
+    <div class="row justify-center hero">
+      <div class="hero-title">Markdown-It! Plugins</div>
+    </div>
+    <main class="content">
+      <div
+        v-for="plugin in mdPlugins"
+        :key="plugin.name"
+        class="section"
+        @click="navigate(plugin.path)"
+      >
+        <q-card flat style="background: transparent">
+          <h2>{{ plugin.name }}</h2>
+          <p>{{ plugin.desc }}</p>
+        </q-card>
+      </div>
+    </main>
+    <div class="row justify-center hero">
+      <div class="hero-title">Vite Plugins</div>
+    </div>
+    <main class="content">
+      <div
+        v-for="plugin in vitePlugins"
+        :key="plugin.name"
+        class="section"
+        @click="navigate(plugin.path)"
+      >
+        <h2>{{ plugin.name }}</h2>
+        <p>{{ plugin.desc }}</p>
+      </div>
+    </main>
+    <div class="row justify-center hero">
+      <div class="hero-title">Quasar App Extensions</div>
+    </div>
+    <main class="content">
+      <div v-for="ext in appExtensions" :key="ext.name" class="section" @click="navigate(ext.path)">
+        <h2>{{ ext.name }}</h2>
+        <p>{{ ext.desc }}</p>
+      </div>
+    </main>
+    <q-separator />
+    <div class="byline">
+      <p>
+        Don't forget to check out the Q-Press app extension for Quasar to create beautiful
+        documentation sites.
+      </p>
+      <p>
+        This site is built with Q-Press! Install it, set it up, choose a theme and start your own
+        site!
+      </p>
+    </div>
+    <q-separator />
+    <div class="byline">
+      <p>
+        We hope you find this documentation helpful. If you have any questions or need further
+        assistance, please don't hesitate to reach out to our support team.
+      </p>
+      <p>Happy coding!</p>
+    </div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { QIcon } from 'quasar'
+import { fabGithub } from '@quasar/extras/fontawesome-v6'
+import { useRouter } from 'vue-router'
+import siteConfig from '../../siteConfig'
+
+const router = useRouter()
+
+const mdPlugins = [
+  {
+    name: 'Blockquote Plugin',
+    desc: 'Adds support for creating Markdown blockquotes.',
+    path: '/md-plugins/blockquote/overview',
+  },
+  {
+    name: 'Codeblocks Plugin',
+    desc: 'Adds support for creating Markdown code blocks.',
+    path: '/md-plugins/codeblocks/overview',
+  },
+  {
+    name: 'Container Plugin',
+    desc: 'Adds support for creating Markdown containers.',
+    path: '/md-plugins/containers/overview',
+  },
+  {
+    name: 'Frontmatter Plugin',
+    desc: 'Adds support for getting frontmatter data into your Markdown.',
+    path: '/md-plugins/frontmatter/overview',
+  },
+  {
+    name: 'Headers Plugin',
+    desc: "Adds support for creating ToC's inMarkdown.",
+    path: '/md-plugins/headers/overview',
+  },
+  {
+    name: 'Image Plugin',
+    desc: 'Adds support for creating Markdown images.',
+    path: '/md-plugins/image/overview',
+  },
+  {
+    name: 'Imports Plugin',
+    desc: 'Adds support for creating custom imports for your Markdown.',
+    path: '/md-plugins/imports/overview',
+  },
+  {
+    name: 'Inlinecode Plugin',
+    desc: 'Adds support for creating Markdown inline code.',
+    path: '/md-plugins/inline-code/overview',
+  },
+  {
+    name: 'Link Plugin',
+    desc: 'Adds support for creating Markdown links.',
+    path: '/md-plugins/link/overview',
+  },
+  {
+    name: 'Table Plugin',
+    desc: 'Adds support for creating Markdown tables.',
+    path: '/md-plugins/table/overview',
+  },
+  {
+    name: 'Title Plugin',
+    desc: 'Adds support for creating Markdown titles.',
+    path: '/md-plugins/title/overview',
+  },
+]
+
+const vitePlugins = [
+  {
+    name: 'Vite MD Plugin',
+    desc: 'Adds support for creating Vue SFCs from Markdown files.',
+    path: '/vite-plugins/vitemdplugin/overview',
+  },
+  {
+    name: 'Vite Examples Plugin',
+    desc: 'Adds support for importing Vue files as raw source.',
+    path: '/vite-plugins/viteexamplesplugin/overview',
+  },
+]
+
+const appExtensions = [
+  {
+    name: 'viteMdPluginAppExt',
+    desc: 'Adds support for creating Vue SFCs from Markdown files.',
+    path: '/quasar-app-extensions/vitemdpluginappext/overview',
+  },
+  {
+    name: 'Q-Press (app-ext)',
+    desc: 'Create beautiful documentation sites with Q-Press.',
+    path: '/quasar-app-extensions/qpress/overview',
+  },
+]
+
+function navigate(path: string) {
+  router.push(path)
+}
+</script>
+
+<style lang="scss" scoped>
+.landing-page {
+  font-family: 'Arial', sans-serif;
+  color: #333;
+}
+
+.hero {
+  background: linear-gradient(135deg, $brand-primary, $brand-secondary);
+  color: white;
+  text-align: center;
+  padding: 50px 20px;
+}
+
+.hero-logo {
+  max-width: 200px;
+  margin-bottom: 20px;
+  border-radius: 50%;
+}
+
+.hero-title {
+  font-size: 3.5em;
+  line-height: 1.2em;
+  font-weight: 700;
+  margin: 0;
+  padding: 0.2em 0;
+  text-shadow: 4px 4px 8px rgba(0, 0, 0, 0.8);
+}
+
+.hero-subtitle {
+  font-size: 1.8em;
+  line-height: 1.8em;
+  margin: 0;
+}
+
+.hero-subtitle2 {
+  font-size: 1.2em;
+  line-height: 1.2em;
+}
+
+.hero-buttons {
+  display: flex;
+  justify-content: center;
+  gap: 10px;
+}
+
+.hero-button {
+  background: white;
+  color: $brand-primary;
+  padding: 10px 20px;
+  border-radius: 5px;
+  text-decoration: none;
+  font-weight: bold;
+  transition: background 0.3s;
+}
+
+.hero-button:hover {
+  background: #f0f0f0;
+}
+
+.byline {
+  text-align: center;
+  font-size: 1.2em;
+  margin: 20px 0;
+  color: #35495e;
+}
+
+body.body--dark .byline {
+  color: #f0f0f0;
+}
+
+.content {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: center;
+  padding: 20px;
+}
+
+.section {
+  flex: 1 1 300px;
+  margin: 20px;
+  padding: 20px;
+  color: white;
+  text-decoration: none;
+  background: linear-gradient(135deg, $brand-primary, $brand-secondary);
+  border-radius: 10px;
+  box-shadow: 0 2px 5px rgba(0, 0, 0, 0.1);
+  transition:
+    transform 0.3s,
+    box-shadow 0.3s;
+}
+
+.section:hover {
+  transform: translateY(-5px);
+  box-shadow: 0 4px 10px rgba(0, 0, 0, 0.2);
+  // change mouseover effects
+  cursor: pointer;
+}
+
+.section h2 {
+  margin-top: 0;
+  color: white;
+  font-size: 2.125rem;
+  font-weight: 400;
+  line-height: 2.5rem;
+  letter-spacing: 0.00735em;
+  font-weight: 700;
+  text-shadow: 4px 4px 8px rgba(0, 0, 0, 0.8);
+}
+
+.section ul {
+  list-style: none;
+  padding: 0;
+}
+
+.section ul li {
+  margin: 10px 0;
+}
+
+.section ul li a {
+  color: #35495e;
+  text-decoration: none;
+  transition: color 0.3s;
+}
+
+.section ul li a:hover {
+  color: $brand-primary;
+}
+
+.footer {
+  text-align: center;
+  padding: 20px;
+  background: #35495e;
+  color: white;
+}
+</style>

package/src/templates/init/src/components/Releases/PackageReleases.vue

@@ -0,0 +1,164 @@
+<template>
+  <div>
+    <q-input class="header-toolbar q-px-md" v-model="search" dense square borderless color="white" placeholder="Search..." clearable>
+      <template #prepend>
+        <q-icon :name="mdiMagnify" />
+      </template>
+    </q-input>
+
+    <q-separator />
+
+    <q-splitter class="release__splitter" :model-value="20" :limits="[14, 90]">
+      <template #before>
+        <q-scroll-area>
+          <q-tabs class="header-tabs" vertical v-model="selectedVersion" active-color="brand-primary" indicator-color="brand-primary">
+            <q-tab v-for="releaseInfo in filteredReleases" class="header-btn" :key="releaseInfo.version" :name="releaseInfo.version" no-caps>
+              <div class="release__tab-label q-pt-xs">{{ releaseInfo.version }}</div>
+              <div class="release__tab-date q-pb-xs">{{ releaseInfo.date }}</div>
+            </q-tab>
+          </q-tabs>
+        </q-scroll-area>
+      </template>
+
+      <template #after>
+        <q-tab-panels class="releases-container" v-model="selectedVersion" animated transition-prev="slide-down" transition-next="slide-up">
+          <q-tab-panel class="q-pa-none" v-for="releaseInfo in filteredReleases" :key="releaseInfo.version" :name="releaseInfo.version">
+            <q-scroll-area>
+              <div class="release__body q-pa-md" v-html="currentReleaseBody" />
+            </q-scroll-area>
+          </q-tab-panel>
+        </q-tab-panels>
+      </template>
+    </q-splitter>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { ref, computed, watch } from 'vue'
+import { mdiMagnify } from '@quasar/extras/mdi-v6'
+
+interface Release {
+  version: string
+  body: string
+  date: string
+  label: string
+}
+
+const props = defineProps<{ releases: Release[] }>()
+
+const search = ref('')
+const selectedVersion = ref(getLatestVersion())
+
+watch(
+  () => props.releases,
+  () => { selectedVersion.value = getLatestVersion() }
+)
+
+function getLatestVersion (): string {
+  return props.releases && props.releases.length > 0 ? props.releases[0]!.version : 'unknown'
+}
+
+const filteredReleases = computed(() => {
+  if (search.value) {
+    const val = search.value.toLowerCase()
+    return props.releases.filter(release => (
+      release.version.indexOf(val) !== -1 ||
+      release.body.toLowerCase().indexOf(val) !== -1
+    ))
+  }
+
+  return props.releases
+})
+
+const currentReleaseBody = computed(() => {
+  const release = props.releases.find(r => r.version === selectedVersion.value)
+  return release ? release.body : ''
+})
+</script>
+
+<style lang="scss">
+.release__splitter .q-scrollarea {
+  height: 600px;
+}
+
+.release__tab-label {
+  font-size: $font-size;
+  font-weight: 700;
+  line-height: ($font-size + 3px);
+}
+
+.release__tab-date {
+  font-size: ($font-size - 3px);
+  line-height: ($font-size + 3px);
+}
+
+.release__body {
+  h1, h2, h3, h4, h5, h6 {
+    padding: 0;
+    margin: .7em 0 .5em;
+    line-height: 1.1em;
+    color: $brand-primary;
+
+    &:first-child {
+      margin-top: 0;
+    }
+  }
+
+  h1 {
+    font-size: ($font-size + 18px);
+  }
+
+  h2 {
+    font-size: ($font-size + 14px);
+  }
+
+  h3 {
+    font-size: ($font-size + 10px);
+  }
+
+  h4 {
+    font-size: ($font-size + 6px);
+  }
+
+  h5 {
+    font-size: ($font-size + 4px);
+  }
+
+  h6 {
+    font-size: ($font-size + 2px);
+  }
+
+  table {
+    white-space: normal;
+    border: 1px solid $separator-color;
+    border-radius: $generic-border-radius;
+    width: 100%;
+    max-width: 100%;
+    border-collapse: separate;
+    border-spacing: 0;
+
+    th, td {
+      text-align: left;
+      padding: 8px 16px;
+    }
+
+    th {
+      font-weight: 700;
+      letter-spacing: $letter-spacing-brand;
+      border-bottom: 1px solid $separator-color;
+    }
+
+    tr:not(:first-child) td {
+      border-top: 1px solid $separator-color;
+    }
+  }
+}
+
+body.body--dark .release__body {
+  table {
+    &, th, tr:not(:first-child) td {
+      border-color: $separator-dark-color;
+    }
+  }
+}
+</style>

package/src/templates/init/src/components/Releases/PublicReleases.vue

@@ -0,0 +1,149 @@
+<template>
+  <q-card flat bordered>
+    <q-card-section v-if="error" class="row no-wrap items-center">
+      <q-icon name="warning" size="24px" color="negative" class="q-mr-sm" />
+      <div>Cannot connect to GitHub. Try again later.</div>
+    </q-card-section>
+
+    <q-card-section v-else-if="loading" class="row no-wrap items-center">
+      <q-spinner size="24px" color="primary" class="q-mr-sm" />
+      <div>Loading release notes from GitHub</div>
+    </q-card-section>
+
+    <template v-else>
+      <q-separator />
+      <q-tab-panels v-model="currentPackage" animated class="packages-container">
+        <q-tab-panel
+          v-for="(packageReleases, packageName) in packages"
+          :key="packageName"
+          :name="packageName"
+          class="q-pa-none"
+        >
+          <PackageReleases
+            v-if="String(latestVersions[packageName]) && packageReleases.length > 0"
+            :latest-version="String(latestVersions[packageName])"
+            :releases="packageReleases"
+          />
+        </q-tab-panel>
+      </q-tab-panels>
+    </template>
+  </q-card>
+</template>
+
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { date } from 'quasar'
+
+import PackageReleases from './PackageReleases.vue'
+
+const { extractDate, formatDate } = date
+
+// Types
+interface ReleaseInfo {
+  version: string
+  date: string
+  body: string
+  label: string
+}
+
+interface PackageReleasesMap {
+  [key: string]: ReleaseInfo[]
+}
+
+// Reactive state
+const packages = ref<PackageReleasesMap>({
+  'MD-Plugins': [],
+})
+const loading = ref<boolean>(false)
+const error = ref<boolean>(false)
+const currentPackage = ref<string>('MD-Plugins')
+const latestVersions = ref<Record<string, string>>({})
+
+function queryReleases(page = 1): void {
+  loading.value = true
+  error.value = false
+
+  const xhr = new XMLHttpRequest()
+
+  xhr.addEventListener('load', function () {
+    const releases = JSON.parse(this.responseText)
+
+    if (!releases || releases.length === 0) {
+      error.value = true
+      return
+    }
+
+    error.value = false
+    let stopQuery = true
+
+    for (const release of releases) {
+      const [name, version] = release.name.split('v')
+
+      if (name.startsWith('@quasar')) {
+        continue
+      }
+
+      const packageName = currentPackage.value
+
+      if (!version) {
+        stopQuery = true
+        continue
+      }
+
+      if (!packages.value[packageName]) {
+        packages.value[packageName] = []
+      }
+
+      const releaseInfo: ReleaseInfo = {
+        version,
+        date: formatDate(extractDate(release.published_at, 'YYYY-MM-DD'), 'YYYY-MM-DD'),
+        body: release.body,
+        label: version,
+      }
+
+      packages.value[packageName].push(releaseInfo)
+
+      if (!latestVersions.value[packageName]) {
+        latestVersions.value[packageName] = releaseInfo.label
+      }
+    }
+
+    if (!stopQuery) {
+      queryReleases(page + 1)
+    }
+
+    if (packages.value['MD-Plugins']) {
+      packages.value['MD-Plugins'].sort((a, b) => {
+        return parseInt(b.date.replace(/-/g, ''), 10) - parseInt(a.date.replace(/-/g, ''), 10)
+      })
+    }
+
+    loading.value = false
+    console.log('Packages:', packages.value)
+    console.log('Latest versions:', latestVersions.value)
+  })
+
+  xhr.addEventListener('error', () => {
+    error.value = true
+  })
+
+  xhr.open(
+    'GET',
+    `https://api.github.com/repos/md-plugins/md-plugins/releases?page=${page}&per_page=100`,
+  )
+  xhr.send()
+}
+
+onMounted(() => {
+  queryReleases()
+})
+</script>
+
+<style lang="scss">
+.packages-container {
+  .q-tab-panel {
+    padding-right: 0;
+    padding-top: 0;
+  }
+}
+</style>