User FAQs

To create your first blog post on Portal of JH:

1. Log in to your account
2. Click "Posts" in the navigation menu
3. Click the "New Post" button
4. Enter a title and write your content using Markdown
5. Add tags to categorize your post (optional)
6. Click "Save Post" to publish

Your post will be visible on the homepage once published!

Portal of JH uses Markdown for post formatting. Here are the most common examples you can copy and use:

Text Formatting

**Bold text**
*Italic text*
***Bold and italic***
~~Strikethrough~~

Headers

# Heading 1
## Heading 2
### Heading 3

Links and Images

[Link text](https://example.com)
![Image alt text](https://example.com/image.jpg)

Lists

- Unordered item 1
- Unordered item 2
  - Nested item

1. Ordered item 1
2. Ordered item 2

Code

Inline `code` with backticks

```elixir
# Code block with syntax highlighting
def hello(name) do
  IO.puts("Hello, #{name}!")
end
```

Blockquotes

> This is a quote
> It can span multiple lines

Just copy these examples and modify them for your content!

Tags help organize and categorize your posts. You can:

• Create tags from the Tags page
• Assign multiple tags to each post
• Use tags to filter and find related posts
• Each tag can have a custom color and description

Readers can click on tags to see all posts with that tag.

Published posts are publicly visible to anyone visiting the site. Draft posts are only visible to you.

You have full control over:

• When to publish (publish immediately or schedule)
• Keeping posts as drafts
• Editing or deleting published posts

Your profile information (display name, bio, avatar) is also publicly visible.

Yes! Portal of JH provides multiple subscription options:

• RSS Feed: Subscribe to receive updates in your RSS reader
• Atom Feed: Alternative XML feed format
• JSON Feed: Modern JSON-based feed format

Feed links are available in the footer of every page. Each post includes reading time estimates to help you plan your reading!

Go to Settings to customize your profile:

• Display Name - How you appear to readers
• Avatar - Profile picture (upload an image)
• Bio - Short description about yourself
• Social Links - Bluesky and Mastodon handles
• Website URL - Link to your personal site

Remember to click "Update Profile" to save your changes!

External Feeds let you aggregate content from other sources into your dashboard:

• RSS/Atom Feeds - Subscribe to any blog or news site
• JSON Feeds - Modern feed format support
• Bluesky - Coming soon
• Mastodon - Coming soon

View all your feeds in one place and stay updated with content you care about.

To register for an account, you need an invitation code from an existing user or administrator. Here's how:

1. Click "Log in" in the navigation menu
2. Click "Register" on the login page
3. Enter your email address, choose a secure password (minimum 8 characters)
4. Enter your invitation code in the designated field
5. Click "Create account"

After registration, you'll receive a confirmation email. Click the link to verify your account and gain full access.

There are two ways to log in:

Standard Login (Email + Password)

1. Click "Log in" in the navigation
2. Enter your registered email address
3. Enter your password
4. Click "Log in"

Magic Link (Passwordless)

1. On the login page, click "Sign in with email link"
2. Enter your email address
3. Check your inbox for the magic link email
4. Click the link to log in instantly (valid for 15 minutes)

Tip: Enable "Remember me" to stay logged in on trusted devices.

If you've forgotten your password:

1. Go to the login page and click "Forgot password?"
2. Enter your registered email address
3. Click "Send reset instructions"
4. Check your email for the reset link (valid for 1 hour)
5. Click the link and enter your new password (minimum 8 characters)
6. Confirm by entering the password again

Security note: The reset link can only be used once. For security reasons, we don't confirm whether an email exists in our system.

The Dashboard is your personal command center showing:

• Statistics: Total posts, tags, and views at a glance
• Recent Activity: Your latest posts and interactions
• Quick Actions: Shortcuts to create new posts or manage tags
• Feed Updates: Latest items from your subscribed external feeds

Access your dashboard anytime by clicking "Dashboard" in the navigation menu after logging in.

Creating a blog post is simple:

1. Click "Posts" in the navigation menu
2. Click the "New Post" button
3. Enter a compelling title for your post
4. Write your content using Markdown formatting
5. Add relevant tags to categorize your post
6. Set a publication date (leave blank for immediate publishing)
7. Click "Save" to publish or "Save as Draft" to continue later

Tip: Use the preview feature to see how your post will look before publishing.

Our editor supports full GitHub Flavored Markdown with these features:

• Headers: Use # for h1, ## for h2, etc.
• Text styling: **bold**, *italic*, ~~strikethrough~~
• Lists: Numbered (1. 2. 3.) and bullet points (- or *)
• Links: [text](url) or auto-linked URLs
• Images: 
• Code: Inline `code` and fenced code blocks with syntax highlighting
• Tables: Using pipe | characters
• Task lists: - [ ] unchecked, - [x] checked
• Blockquotes: > for quoted text

Code blocks support syntax highlighting for Elixir, JavaScript, Python, and 100+ languages.

To edit a post:

1. Go to "Posts" and find the post you want to edit
2. Click the post title to view it, then click "Edit post"
3. Or click the edit icon (pencil) directly from the post list
4. Make your changes and click "Save"

To delete a post:

1. Open the post you want to delete
2. Click the "Delete" button
3. Confirm the deletion when prompted

Warning: Deleted posts cannot be recovered. Consider unpublishing instead by clearing the publication date.

Post visibility depends on the publication status:

• Published posts (with a publication date): Visible to everyone, including non-logged-in visitors
• Draft posts (no publication date): Only visible to you
• Future-dated posts: Hidden until the publication date arrives

Published posts appear on:

• Your public profile page (/users/@username)
• Tag pages for any tags you've assigned
• Site-wide search results
• RSS/Atom/JSON feeds

Creating tags:

1. Go to "Tags" in the navigation
2. Click "New Tag"
3. Enter a name (unique, descriptive)
4. Optionally add a description
5. Click "Save"

Using tags in posts:

1. When creating or editing a post, find the "Tags" field
2. Select existing tags from the dropdown
3. Posts can have multiple tags

Benefits of tags:

• Help readers find related content
• Organize your posts by topic
• Each tag has its own page showing all tagged posts

To change your email address:

1. Go to Settings → Email section
2. Enter your new email address
3. Enter your current password to confirm
4. Click "Change email"
5. Check your new email for a confirmation link
6. Click the confirmation link to activate the new address

Important: Your old email remains active until you confirm the new one. The confirmation link expires after 1 hour.

To change your password while logged in:

1. Go to Settings → Password section
2. Enter your current password
3. Enter your new password (minimum 8 characters)
4. Confirm by entering the new password again
5. Click "Change password"

Password requirements:

• Minimum 8 characters
• Mix of letters, numbers, and symbols recommended
• Avoid common words or personal information

Your blog automatically provides feeds in three formats:

• RSS:/users/@username/rss.xml
• Atom:/users/@username/feed.xml
• JSON Feed:/users/@username/feed.json

Readers can subscribe using any feed reader like Feedly, Inoreader, NetNewsWire, or Newsblur.

The site also provides global feeds:

• RSS: /rss.xml
• Atom: /feed.xml
• JSON: /feed.json

Feed links are automatically included in your page's HTML for autodiscovery.

Use the Search feature in the navigation to find content:

1. Click the search icon or "Search" in the menu
2. Enter your search terms
3. Press Enter or click Search

Search finds:

• Blog posts (titles and content)
• Tags (names and descriptions)
• FAQs (questions and answers)

Tips:

• Use multiple keywords for more specific results
• Search is case-insensitive
• Results are ranked by relevance

The Media Library lets you upload and organize images and files:

1. Go to "Media" in the navigation
2. Click "Upload" or drag files into the upload area
3. Supported formats: JPG, PNG, GIF, WebP (images), PDF (documents)
4. Maximum file size: 10MB per file

Organizing media:

• Add tags to categorize your media
• Use the search to find specific files
• Click any item to view details and get embed URLs

Using in posts: Copy the media URL and use Markdown image syntax: ![description](url)

Projects let you showcase your work in organized collections:

Project Types:

• Portfolio: Showcase your best work publicly
• Library: Organize media into private collections

Creating a project:

1. Go to "Projects" in the navigation
2. Click "New Project"
3. Choose a type (Portfolio or Library)
4. Add a title, description, and cover image
5. Add media items to the project
6. Set visibility (public or private)

Portfolio projects are displayed on your public profile page for visitors to browse.

We value your feedback! Here's how to share your thoughts:

1. Click "Feedback" in the navigation or footer
2. Rate your overall experience (happiness meter)
3. Share specific feedback or suggestions
4. Optionally allow your feedback as a testimonial
5. Submit your feedback

What we'd love to hear:

• Features you'd like to see
• Issues you've encountered
• What you enjoy about the site
• Suggestions for improvement

Your feedback helps us improve the platform for everyone!

We take security seriously. Your account is protected by:

• Secure password hashing: Using Argon2, the industry standard
• HTTPS encryption: All data is encrypted in transit
• CSRF protection: Prevents cross-site request forgery
• Rate limiting: Protects against brute-force attacks
• Secure sessions: Auto-logout after inactivity

Best practices:

• Use a unique, strong password
• Don't share your login credentials
• Log out on shared devices
• Report any suspicious activity