-
Notifications
You must be signed in to change notification settings - Fork 224
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
33 changed files
with
307 additions
and
143 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,75 +1,9 @@ | ||
| import { base } from '$app/paths'; | ||
| import type { AuthorData } from '$markdoc/layouts/Author.svelte'; | ||
| import type { CategoryData } from '$markdoc/layouts/Category.svelte'; | ||
| import type { PostsData } from '$markdoc/layouts/Post.svelte'; | ||
| import { posts, authors, categories } from './content'; | ||
|
|
||
| export function load() { | ||
| const postsGlob = import.meta.glob('./post/**/*.markdoc', { | ||
| eager: true | ||
| }); | ||
| const authorsGlob = import.meta.glob('./author/**/*.markdoc', { | ||
| eager: true | ||
| }); | ||
| const categoriesGlob = import.meta.glob('./category/**/*.markdoc', { | ||
| eager: true | ||
| }); | ||
|
|
||
| const posts = Object.entries(postsGlob) | ||
| .map(([filepath, postList]) => { | ||
| const { frontmatter } = postList as { | ||
| frontmatter: PostsData; | ||
| }; | ||
| const slug = filepath.replace('./', '').replace('/+page.markdoc', ''); | ||
| const postName = slug.slice(slug.lastIndexOf('/') + 1); | ||
|
|
||
| return { | ||
| title: frontmatter.title, | ||
| description: frontmatter.description, | ||
| date: new Date(frontmatter.date), | ||
| cover: frontmatter.cover, | ||
| timeToRead: frontmatter.timeToRead, | ||
| author: frontmatter.author, | ||
| category: frontmatter.category, | ||
| href: `${base}/blog/post/${postName}` | ||
| }; | ||
| }) | ||
| .sort((a, b) => { | ||
| return b.date.getTime() - a.date.getTime(); | ||
| }); | ||
|
|
||
| const authors = Object.values(authorsGlob).map((authorList) => { | ||
| const { frontmatter } = authorList as { | ||
| frontmatter: AuthorData; | ||
| }; | ||
|
|
||
| return { | ||
| name: frontmatter.name, | ||
| slug: frontmatter.slug, | ||
| role: frontmatter.role, | ||
| avatar: frontmatter.avatar, | ||
| bio: frontmatter.bio, | ||
| twitter: frontmatter.twitter, | ||
| linkedin: frontmatter.linkedin, | ||
| github: frontmatter.github, | ||
| href: `${base}/blog/author/${frontmatter.slug}` | ||
| }; | ||
| }); | ||
|
|
||
| const categories = Object.values(categoriesGlob).map((categoryList) => { | ||
| const { frontmatter } = categoryList as { | ||
| frontmatter: CategoryData; | ||
| }; | ||
|
|
||
| return { | ||
| name: frontmatter.name, | ||
| description: frontmatter.description, | ||
| href: `${base}/blog/category/${frontmatter.name.toLowerCase()}` | ||
| }; | ||
| }); | ||
|
|
||
| return { | ||
| posts, | ||
| authors, | ||
| categories | ||
| }; | ||
| return { | ||
| posts, | ||
| authors, | ||
| categories | ||
| }; | ||
| } |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,11 @@ | ||
| --- | ||
| layout: author | ||
| slug: luke-silver | ||
| name: Luke B. Silver | ||
| role: Software Engineer | ||
| bio: Building integrations with and on Appwrite | ||
| avatar: /images/avatars/luke.png | ||
| twitter: https://twitter.com/lukebsilver | ||
| github: https://github.com/loks0n | ||
| linkedin: https://www.linkedin.com/in/lukebsilver/ | ||
| --- |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,91 @@ | ||
| import { base } from '$app/paths'; | ||
| export type CategoryData = { | ||
| name: string; | ||
| description: string; | ||
| href: string; | ||
| }; | ||
| export type AuthorData = { | ||
| name: string; | ||
| slug: string; | ||
| role: string; | ||
| avatar: string; | ||
| bio: string; | ||
| twitter: string; | ||
| linkedin: string; | ||
| github: string; | ||
| href: string; | ||
| }; | ||
| export type PostsData = { | ||
| title: string; | ||
| description: string; | ||
| date: Date; | ||
| cover: string; | ||
| timeToRead: number; | ||
| author: string; | ||
| category: string; | ||
| href: string; | ||
| featured?: boolean; | ||
| }; | ||
|
|
||
| const postsGlob = import.meta.glob('./post/**/*.markdoc', { | ||
| eager: true | ||
| }); | ||
| const authorsGlob = import.meta.glob('./author/**/*.markdoc', { | ||
| eager: true | ||
| }); | ||
| const categoriesGlob = import.meta.glob('./category/**/*.markdoc', { | ||
| eager: true | ||
| }); | ||
|
|
||
| export const posts = Object.entries(postsGlob) | ||
| .map(([filepath, postList]) => { | ||
| const { frontmatter } = postList as { | ||
| frontmatter: PostsData; | ||
| }; | ||
| const slug = filepath.replace('./', '').replace('/+page.markdoc', ''); | ||
| const postName = slug.slice(slug.lastIndexOf('/') + 1); | ||
|
|
||
| return { | ||
| title: frontmatter.title, | ||
| description: frontmatter.description, | ||
| date: new Date(frontmatter.date), | ||
| cover: frontmatter.cover, | ||
| timeToRead: frontmatter.timeToRead, | ||
| author: frontmatter.author, | ||
| category: frontmatter.category, | ||
| href: `${base}/blog/post/${postName}` | ||
| }; | ||
| }) | ||
| .sort((a, b) => { | ||
| return b.date.getTime() - a.date.getTime(); | ||
| }); | ||
|
|
||
| export const authors = Object.values(authorsGlob).map((authorList) => { | ||
| const { frontmatter } = authorList as { | ||
| frontmatter: AuthorData; | ||
| }; | ||
|
|
||
| return { | ||
| name: frontmatter.name, | ||
| slug: frontmatter.slug, | ||
| role: frontmatter.role, | ||
| avatar: frontmatter.avatar, | ||
| bio: frontmatter.bio, | ||
| twitter: frontmatter.twitter, | ||
| linkedin: frontmatter.linkedin, | ||
| github: frontmatter.github, | ||
| href: `${base}/blog/author/${frontmatter.slug}` | ||
| }; | ||
| }); | ||
|
|
||
| export const categories = Object.values(categoriesGlob).map((categoryList) => { | ||
| const { frontmatter } = categoryList as { | ||
| frontmatter: CategoryData; | ||
| }; | ||
|
|
||
| return { | ||
| name: frontmatter.name, | ||
| description: frontmatter.description, | ||
| href: `${base}/blog/category/${frontmatter.name.toLowerCase()}` | ||
| }; | ||
| }); |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,12 @@ | ||
| import type { RequestHandler } from './$types'; | ||
| import { posts } from '../content'; | ||
| import { json } from '@sveltejs/kit'; | ||
|
|
||
| export const prerender = true; | ||
|
|
||
| export const GET: RequestHandler = () => { | ||
| return json({ | ||
| posts, | ||
| total: Object.keys(posts).length | ||
| }); | ||
| }; |
60 changes: 60 additions & 0 deletions
60
src/routes/blog/post/adding-url-shortener-function/+page.markdoc
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,60 @@ | ||
| --- | ||
| layout: post | ||
| title: Add a URL shortener function to your application | ||
| description: Learning how to add the URL shortener function template to your application. | ||
| cover: /images/blog/adding-url-shortener/cover.png | ||
| timeToRead: 5 | ||
| date: 2023-11-08 | ||
| author: haimantika-mitra | ||
| category: functions | ||
| featured: false | ||
| --- | ||
|
|
||
| Appwrite Functions are user-defined functions that can start small and scale big, deploying automatically from source control. With the introduction of function templates, you can quickly add new integrations into your app without writing additional code or managing infrastructure. Function templates are pre-built Appwrite Functions that can be integrated into your Appwrite project with just a few clicks. | ||
|
|
||
| A URL shortener takes a long or complex URL and generates a shorter, more concise version. The primary purpose of a URL shortener function is to make links easier to share, manage, and remember. | ||
| For e.g https://dev.to/appwrite/introducing-appwrite-migrations-effortless-data-migration-from-your-platforms-5dhh to http://tinyurl.com/bd5usb3n | ||
|
|
||
| In this blog, we’ll learn to build a URL shortener using Appwrite Functions template. The template benefits from the built-in scalability, reliability, and security of Appwrite Functions. | ||
|
|
||
| You can find the source code on our [templates GitHub repository](https://github.com/appwrite/templates/tree/main/node/url-shortener). | ||
|
|
||
| # Setting up the Template | ||
| To get started, you need to navigate to the functions page on the **[Appwrite](https://appwrite.io/cloud)** console. From there, we will select the **Templates** tab, search for and select the **URL Shortener** function template. | ||
|
|
||
|  | ||
|
|
||
| The function requires two variables: | ||
| - `APPWRITE_API_KEY` | ||
| - `SHORT_BASE_URL` | ||
|
|
||
|  | ||
|
|
||
| Once you have populated those, you can go straight to the **Connect** step. | ||
|
|
||
|  | ||
|
|
||
| Select **Create a new repository** (this will generate a GitHub repository for you with the function), and leave the production branch and root settings as default to create this function. | ||
|
|
||
| # Using the Function | ||
|
|
||
| Visit the **Domains** tab on the function page and copy the domain URL to test the function. | ||
|
|
||
|  | ||
|
|
||
| Go to the function URL in your web browser, and you'll see a short url like the one shown below. | ||
|
|
||
| # Next Steps | ||
|
|
||
| URL shorteners often offer additional features such as tracking click-through rates, providing analytics on link usage, and allowing users to customize the shortened URL to some extent.This Function Template can be extended to perform a lot of functionalities. Some examples are: | ||
|
|
||
| 1. **Link Analytics and Tracking:** Enhance the URL shortener to track click-through rates, geographical location of users, referral sources, and other analytics data. This could provide valuable insights into the popularity and effectiveness of shared links. | ||
| 2. **Link Management Dashboard:** Create a user-friendly dashboard where users can manage their shortened links, view statistics, and perform various actions on their links. | ||
|
|
||
| Be sure to check out the other available Function Templates. We’ve created many that could be of use in your projects. You can find the [templates GitHub repository here](https://github.com/appwrite/templates). | ||
|
|
||
| For more information about Appwrite and Appwrite Functions: | ||
|
|
||
| 1. **[Appwrite Function Docs](https://appwrite.io/docs/functions)**: These documents provide more information on how to use Appwrite Functions. | ||
| 2. **[Functions Announcement](https://dev.to/appwrite/serverless-your-way-unleashing-appwrite-functions-true-potential-2l4f)**: Read the full announcement on Functions 1.4. | ||
| 3. **[Appwrite Discord](https://discord.com/invite/appwrite)**: Connect with other developers and the Appwrite team for discussion, questions, and collaboration. |
Oops, something went wrong.