Twilight

Также доступна RU версия => README-RU.md

Table of Contents

• Idea
• Platform support
• Installation
• Setting up
  • Comments
  • Matrix
  • fail2ban
  • Themes
• Current features
• Bugs and some features
• Schemas and screenshots
• Contact

P.S. The list of recent changes can be found here

Idea

Analyzing various blog sites and the platforms adjacent to them (where the repost goes), we can single out the main problem: Each platform, in fact, has nothing to do with other platforms or with the blog. It follows from this:

1. Stupidity to post the same thing in different places;
2. The need to exists in other platforms yourself;

Therefore, it was customary to write something like an article aggregator. The idea is simple - you write a post - it scatters across different platforms.

For a visual representation of the implementation, see Schemes and screenshots;

Platform support

• Telegram:

  • Send to platforms: Yes
  • Editing, deleting: Yes
  • Send from platform to site: Yes
  • Comment support: Yes
  • Support for attachments: pictures, video, audio, files

• Matrix:

  • Send to platforms: Yes
  • Editing, deleting: Yes
  • Send from platform: No
  • Support for attachments: pictures, video, audio, files

Installation

There are 2 ways of installation:

Manual

• Install ruby (3.3.2):

  • For rvm:

   rvm install ruby-3.3.2
  

  • For rbenv:

   rbenv install 3.3.2
  

• Install yarn: Windows | Linux;

• Install redis: Windows | Linux;

• Install imagemagick Windows | Linux

• (Optional) Install PostgreSQL;

• Install project:

   git clone https://github.com/Whiletruedoend/Twilight
   cd Twilight/
   yarn install --check-files
   bundle install
   NODE_OPTIONS=--openssl-legacy-provider bundle exec rake webpacker:compile
   NODE_OPTIONS=--openssl-legacy-provider bundle exec rake assets:precompile
   rails db:migrate
  

• Setting up: config/credentials.yml

• Run server with command: rails s

Windows gem install fixes:

gem install pg -- --with-pg-dir="C:\Program Files\PostgreSQL\15" (insert your path)
gem install wdm -- --with-cflags=-Wno-implicit-function-declaration

Docker

git clone https://github.com/Whiletruedoend/Twilight
cd Twilight/
yarn

• (Optional) Configure .env for existing postgres database
• Configure config/credentials.yml
• Run:

  docker build -t twilight .

• After a successful build, run:

  docker-compose up twilight

• (If you need make migrations, use):

  docker-compose run --rm twilight bin/rails db:migrate

The site will now be available at: http://localhost:3080

Comments

To support broadcasting comments from Telegram to a blog post, you need to:

1. Check the bot's privacy settings;
2. Add a bot to the chat with comments;
3. When adding a channel, check the 'Include comments' checkbox;

After that, the translation of comments should work.

Matrix

A quick guide to setting up the matrix.

1. Access is through the access_token. Receiving it through the Element client: Settings -> Help & About --> *at the bottom* Acess token
2. To get the room ID, create a room, then RMB on the room and Settings --> Details --> and here 'Internal room ID'

fail2ban

To be able to block the IP addresses of those who are trying to bypass the RSS token, used fail2ban. Instructions:

• Install fail2ban;
• Setting up credentials.yml: switch enabled: on true;
• Create filter: vim /etc/fail2ban/filter.d/twilight.conf
• Paste there:

  [INCLUDES]
  before = common.conf
  
  [Definition]
  failregex = ^.* (\[.*\])* Failed bypass token from <HOST> at .*$
  

• Create jail: vim /etc/fail2ban/jail.d/twilight.conf
• Paste there:

  [twilight]
  enabled = true
  maxretry = 7
  findtime = 180
  action = iptables-allports[name=twilight, protocol=all]
  bantime = 3600
  filter = twilight
  port = http,https
  logpath = /home/user/Twilight/log/production.log
  

  (Important! Don't forget to change the logpath to your own. For more information about the parameters, see the link above);
• Restart service: systemctl restart fail2ban

(Banned IPs can be found with the command: sudo fail2ban-client status twilight)

Themes

To create your own theme, you need to create a file in the format app/assets/stylesheets/mytheme_theme.scss, edit it, then restart the application;

Production

For the production, do not forget to recompile the assets:

RAILS_ENV=production bundle exec rake assets:precompile

Current features

• EN/RU languages support;
• Ability to create/change themes;
• Channel management, verification of data when entering (only for administrators);
• Search for notes by title on the home page;
• Captcha for authorization/registration;
• The system of invite codes (optional);
• Support for separate options for each platform;
• Access specifiers notes (for everyone, for users, for yourself);
• Create Delete tags, the ability of the user to select the desired tags (the result is displayed in RSS);
• Ability to add comments to the article;
• View statistics of registered users (only for administrators);
• Twitter-style feed;

Bugs and some features

Features:

• [ANY] If you delete a channel and then delete a post, then the post will not be deleted from the platforms (no tokens - no deletion, it seems logical);
• [TG] If a post in telegram had text and attachments, and when editing, remove all attachments, then the post will be completely deleted. This is a feature of the cart, I cannot turn the capture into text, I need to create a new post;
• [TG] If you send several attachments of different types and use a caption, the attachments will be grouped into groups, the first group will be of the same type as the first attachment, and the caption will be attached to it;
• [TG] If a post was created with <= 4096 characters and when the post is updated its length will exceed 4096 characters, then a new message will be created, which may be at a far distance from the first one (for example, if there were more posts, it will go after them). I cannot move the message up, so I advise you to use the onlylink option in such cases;

Bugs:

• [TG] When editing attachments in comments (adding a new one and deleting an old one), the order gets lost and when you edit it again, the wrong picture is deleted;

If you decide to fix them, I'll gladly accept the Pull Request;

Schemas and screenshots

ER-diagram(Ver. 1.0.1): Main page (configurating):

• Version 0 (standalone page):
• Version 1 [default] (posts):
• Version 2: (feed): Profile page: Manage channels: Invite codes: Statistics: Article creation (Default theme): Specific article:

Contact

If you have any ideas or your own developments, then you can always contact me at the following addresses:

• Matrix